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PREFACE 


This publication provides information necessary to program the MRX/40 or 50 System for 
telecommunications applications at the logical or physical level. The programmer using this 
manual is assumed to have experience in telecommunications programming. Chapter 11 
contains information on Control Language statements for telecommunications. The 
expansions of the various macros and control blocks, and error recovery procedures are 
covered in the appendixes. 


GLOSSARY 


Asynchronous Data Transfer — In this transmission method, each byte is sent separately, 
with a preceding start bit and one or two following stop bits to provide hardware 
synchronization. 


Duplex Line — A communications line that can transmit data in both directions at the same 
time. 


Half-Duplex Line — A communications line that can transmit data in either direction, but 
not at the same time. 


Integrated Communications Adapter — A communications hardware adapter that converts 
data on a communication line into a form that is acceptable to the processing unit, and vice 
versa. The functions of the ICA include assembly of bits into characters, checking data for 
validity, inserting and stripping of checking characters, and buffering of data. The ICA 
performs functions similar to a transmission control unit. 


Local Line — A communications line that only covers a short distance (for the MRX/40 and 
50 systems the maximum length of local lines is 50 ft.). Local lines connect directly to the 
ICA, do not require modems, and are used without dialing or operator intervention. 


Logically Enabled — The hardware has been primed for connection, but connection has not 
been established. 


Modem — A device leased or bought from a common carrier that converts the signals of a 
terminal to a signal that can be transmitted on a communications line, and vice versa. This 
terminal-to-line and line-to-terminal conversion is called MOdulation/DEModulation and is 
required to send signals over any distance. Modems may also be referred to as data sets. 


Non-Switched Line — A communications line that connects distant points (requiring 


modems), and has a leased line connection between the terminal and ICA. These lines do 
not require dialing or operator intervention for message transfer. 


Physically Enabled — A connection has been established. 


Simplex Line — A communications line that can transmit data in one direction only. 


Switched Line — A communications line that connects distant points (requiring modems) 
and requires dialing or operator intervention to connect the terminal and ICA. 


Synchronous Data Transfer — In this transmission method, a series of bytes is sent at one 
time. There are no start-stop bits for each byte; instead, each block of bytes is preceded by 
synchronization characters. 
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1. INTRODUCTION 


The Memorex Telecommunications System is a combination of software and hardware that 
provides the user with the ability to communicate between central and remote locations. 


There are two levels of programming in the telecommunications system, logical 
programming (Logical TCOM) and physical programming (Physical TCOM). The user 
communicates with both of these programs with two distinct sets of macros. The difference 
between these two programming levels is that Physical TCOM is at a much more basic level 
of programming than Logical TCOM. 


The Physical TCOM user is concerned with such tasks as framing messages, translating 
messages, requesting !/O service, error recovery procedures, and writing command programs. 
Although the Physical TCOM user must be concerned with such basic functions, he has the 
advantage of being able to write programs for any terminal, even those not supported by 
Logical TCOM. 


Logical TCOM provides all the basic functions for the programmer, so that he can be more 
concerned with direct communication with the remote terminal. If the Logical TCOM 
system is somewhat easier to use than Physical TCOM, it also occupies more storage than 
Physical TCOM. The programmer may use either or both of these programming levels 
depending on the nature of his applications program. 


Data transfer in the telecommunications system may be by synchronous or asynchronous 
transmission, over switched or non-switched lines, using USASCII or EBCDIC code. For 
complete information on transmission conventions, refer to Chapter 3. Transmission and 
Line Definitions. 


2. HARDWARE CONFIGURATION 


MINIMUM CONFIGURATION 


Telecommunications can be supported by any Memorex/40 or 50 system with a minimum 
of 24K bytes of storage. The 24K byte system supports only physical communications, one 
switched or non-switched line, and asynchronous and nontransparent synchronous data 
transmission. 


MAXIMUM CONFIGURATION 


Memory capacities larger than 24K bytes will permit full use of the MRX/40’s seven 
communication lines or the MRX/50's fifteen communications lines. The lines can be 
connected to switched or non-switched lines, carrying asynchronous or nontransparent 
synchronous data. 


SYSTEM STORAGE REQUIREMENTS 
Appendix B contains the information needed to determine the Physical and Logical TCOM 
system storage capacities. (The storage required for individual macro expansions is given in 


the discussion of each macro in Chapter 6. Logical Communications Macros or Chapter 8. 
Physical Communications Macros. ) 


TERMINALS SUPPORTED BY TCOM 


The asynchronous terminals in Table 2-1 are supported by TCOM. 


Table 2-1. Asynchronous Terminals Supported by TCOM 


Terminal Code (ASCII) 


MRX 1240 — half duplex 110/150/300/600 odd/even/no parity 
MRX 1250 110/150/300/600 odd/even/no parity 
MRX 1280 110/150/300/600/1200 odd/even/no parity 
TTY 33 KSR and ASR 110 ~ edd/even/no parity 
TTY 35 KSR and ASR 110 even/no parity 

TTY 37 KSR and ASR 150 odd/even/no parity 
TTY 38 KSR and ASR 110 odd/even/no parity 


Synchronous terminals which operate at speeds of 600 to 4800 baud are supported ina 
transparent or nontransparent EBCDIC mode or a nontransparent ASCII mode. 


MODEM/LINE TYPES SUPPORTED BY TCOM 


The modem/line types shown in Table 2-2 are supported by TCOM. 


2-1 


CC 


Table 2-2. Modem/Line Type Descriptions 


Answer & 
Modem/ Half/ Async/ Transp/ Leased/ Manual Dial/ 
Line Type Full Duplex Sync Non-Transp Switched Calling Recommended Speeds 


NT WE 201A 
WE 202C,D 
«|» >= | ee 
WE 202C,D i 
AA H s | Nt | 2-Wire Secondary Channel | S | A aS eaeere 
| 202C, D — 600 or 1200 BPS 


WE 201A,B 203A — 1800, 2400, 3600 or 
WE 202C,D 4800 BPS 

WE 203A 

WE 208A 208A — 4800 BPS 


WE 201A,B 


WE 202C,D 
WE 203A 
WE 208A 


Multipoint 


WE 201A 
WE 202C,D 


H Ss T WE 202C,D 2-Wire L —_ 
| Secondary Channel 
po NONE (Local E!1A-RS-232-C) i i ee 1240 — 600 or 1200 BPS 


WE 103A,E,F 
84* H A - WE 113B L ~ 
WE 202C,D 4-Wire 


oc 


Table 2-2. Modem/Line Type Descriptions (Continued) 


Answer& 
Transp/ Leased/ Manual/Dial/ 


Modem/ Half/ 


Line Type Full Duplex Non-Transp Switched Calling Recommended Speed 


WE 103F 
WE 202C,D 
4-Wire 


103A,E,F 113B 
110,150 or 300 BPS 


Multipoint 


202C,D — 600 or 1200 BPS 


a ae 
202C,D 
2-Wire Secondary Channel ae a 600 or 1200 BPS 


8E H A - 2-Wire Ss A 


WE 103A,E 
WE 1138 


WE 202C,D 


600/75 or 1200/75 BPS 


Split Speed 


A4 H NT WE 201A,B 

WE 202C,D 

WE 203A L 201A — 2000 BPS 

WE 208A 201B — 2400 BPS 

202C,D — 600 or 1200 BPS 

WE 201A,B 203A — 1800, 2400, 3600 or 
AS NT WE 202C,D Multipoint L 4800 BPS 

WE 203A 208A — 4800 BPS 

WE 208A 


*84 is the line type used to describe direct line connections which do not include modems at 10, 15, or 30. 


3. TRANSMISSION AND LINE DEFINITIONS 


LINE CONFIGURATION 


Data may be transferred between a remote location and the computer over local, 
non-switched or switched lines. 


Local lines cover a short distance, and thus do not require modems. They connect directly 
to the Integrated Communications Adapter (ICA), and do not require dialing or operator 
intervention for message transfer. 


Non-switched lines connect distant points, requiring modems, and have a direct connection 
from the terminal to the ICA. These lines do not require dialing or operator intervention for 
message transfer. 


Switched lines connect distant points, requiring modems, and require dialing or operator 
intervention to connect the terminal and the ICA. A switched connection may be made 
from the terminal or from the computer. 


Figure 3-1 shows a block diagram of local, non-switched, and switched line connections. 


Legend 


: 
© 


Terminal 


Common Carrier Modem 


Figure 3-1. Line Configuration 


TRANSMISSION CODES 


MRX/OS Telecommunications (TCOM) supports the Extended Binary Coded Decimal 
Interchange Code (EBCDIC) and the United States of America Standard Code for 
Information Interchange (USASCII). When programming at the logical level, all received 
USASCII data is translated by the system into EBCDIC before being placed in the user’s 
storage area. Likewise, all EBCDIC data in a user’s storage area is translated by the system to 
USASCI! before being placed on an asynchronous line. Under physical level programming, 
the user is responsible for code translation. 


The following illustration shows the bit positions for the EBCDIC and USASCII codes. 


EBCDIC | 


USASCII 


Most Least 
significant significant 
bit bit 

position position 


The USASCII code may be transmitted with even, odd, or no parity. Only one parity 
convention per line is permissible at the logical level, but at the physical level the parity 
convention can be altered. 


Under USASCII odd- or even-parity transmissions, the hardware adds the parity bit before 
the bits are transmitted to the line. (When transmitting without parity, no parity is 
checked.) USASCII data received by the computer is checked for good parity. If the parity 
is good, the parity bit is stripped from the byte before the byte is stored in the buffer. Bytes 
with faulty parity have a one-bit inserted in the parity position before the byte is stored in 
the buffer. Therefore, the physical level programmer must test the parity bit to determine 
bad parity. 


Appendix A contains the hexadecimal assignments used for the EBCDIC and USASCII 
characters, printer graphics, and control symbols used during data transmission. 


TRANSMISSION CONVENTIONS 
Line data transfer occurs by asynchronous or synchronous transmission. 


In asynchronous data transfer, each byte in the transmitted message is sent as an entity. One 
byte comprises one start bit followed by the data code and one or two stop bits. The start 
and stop bits are added by the hardware at transmission time and are used to synchronize 
the hardware at the receiving end. Figure 3-2 illustrates an asynchronous data byte with one 
stop bit. One asynchronous message will comprise many asynchronous bytes with the 
proper message framing text and line control characters. In asynchronous transmission, 
control characters normally terminate data transmission; however, the use of control 


characters is governed by the terminal used and not by convention. The user may frame his 
own message if he chooses physical level programming, or he can select logical level 
programming, and specify the framing characters required to frame his messages. 


2 fs fete fez | se 


Figure 3-2. Asynchronous Data Byte 


Synchronous data transfer transmits a block of data at transmission time. No start or stop 
pulses are transmitted with each byte, but synchronization bytes precede each transmission. 
Those sync bytes are added by the hardware and used by the receiving device to establish 
sync prior to reception of data. Once line sync is established, the message is transmitted 
with its proper control characters for message framing and padding. Not all messages will 
contain a pad character. Pad characters are used only by certain receiving devices. The 
transmitted block ends with a hardware inserted block check character. The hardware uses 
this character to determine transmission errors. Error action taken by the system depends 
on the programming options selected by the user. 


Control characters must precede and terminate each synchronous transmitted message. 
Since the message heading or text information could contain bytes that appear as 
termination control characters, premature termination of a message could occur. To prevent 
early message termination, a Data Link Escape (DLE) control sequence is performed at the 
start and termination of a message. This control operation causes all bytes that are control 
characters in the message to appear transparent to the Integrated Communications Adapter’s 
control sensing logic. Messages under control of a DLE data control sequence are often 
referred to as transparent messages. Messages that are not under control of a DLE sequence 
are often referred to as nontransparent messages. Figure 3-3 illustrates a data block for 
nontransparent and transparent messages. Transparent text is not supported by the first 
release of MRX/OS, but will be supported in a later release. 


Structuring the message for synchronous transmission can be the responsibility of the user 
or systern. If the user decides to use physical-level programming, he must provide all timing, 
framing, and message translation needed by the receiving device. If he decides to leave 
structuring to the system by selecting logical-level programming, he need not worry about 
timing, framing, or message translation. 
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Non-Transparent Data Block 
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Control Characters 
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Figure 3-3. Synchronous Data Blocks — Transparent and Nontransparent 
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4. STANDARD SYMBOLS 


The instructions in this manual are presented using certain symbols used to define which 
entries are required, required but named by the user, or optional. The chart below shows 
these symbols and defines their meanings. 


ABCXYZ Must appear in the coding as shown, 
abexyz A required entry representing one name selected by the user. 


One and only one entry in the | ' must be selected. An entry that is underlined 
is a default value, which is used if the programmer does not select any of the entries 
in the brackets. If no entry is underlined, there is no default value. 


[LM=abc] Items enclosed in [ ] are optional entries. 


abcxyz are defined in the description of the macro using this notation. 


1279 


g swowe $ One or more entries in must be selected. Limits on the selection of options 


NOTE 


The brackets defined above are only used to present the instructions, they are not coded. Parentheses ( ) that 
appear in a statement are used to set off operand lists — these parentheses must be coded if the list format is 
used. 


Figure 4-1. Standard Symbol Definition 
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5. LOGICAL COMMUNICATIONS PROGRAMMING 


INTRODUCTION 


The programmer communicates with the Logical TCOM program by using several macros to 
define the terminals and control message transfer. The physical-level control functions are 
all automatically provided by Logical TCOM (Logical TCOM uses Physical TCOM for these 
tasks), so that the user does not have to concern himself with line control, error recovery, 
and so forth. Logical TCOM provides the following services for the programmer: message 
framing, message translation, editing, and error recovery. 


MESSAGE FRAMING AND RESPONSE CHARACTERS 


Logical TCOM provides the STX, CR, LF, ETX, NUL, EOT, and ENO output line control 
and message framing characters for asynchronous and synchronous transmission. However, 
during terminal communication, the user must provide all tabulation characters in his work 
area. Furthermore, if the asynchronous message contains more data than can be placed on a 
line, the user must provide control characters in his work area to return the carriage and 
advance paper before the line length is exceeded. For a detailed explanation of how Logical 
TCOM performs message framing for a terminal response, refer to Appendixes H and I. 


MESSAGE TRANSLATION 


Logical TCOM translates all received USASCII data to EBCDIC. Lower case received 
USASCII alphabetic characters are translated to upper case EBCDIC alphabetic characters. 
Transmitted messages that require translation from EBCDIC to USASCII are translated to 
support the terminal line code. 


EDITING FUNCTIONS 


All received USASCII coded messages are stripped of the STX, backspace, delete, rubout 
and null control characters, and edited in accordance with the control characters received. 
When a CAN or ENO message delete code is sensed, the input message is prevented from 
passing to the user work area. 


ERROR RECOVERY SERVICES 


Logical TCOM performs all hardware error recovery and reports the success of each logical 
communications operation in the parameter packet’s return code field. The user may also 
gain additional information about the operation by testing the Primary and Secondary 
status words in the terminal prefix area. It is the user’s responsibility to terminate the line 
connection if an irrecoverable error is sensed and no user subroutine is available to assign the 
task to alternate terminals. (A detailed explanation of Logical TCOM error recovery can be 
found in Appendix J.) 
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LOGICAL TCOM RESTART 


If a job step terminates abnormally, the operator is queried for permission to restart. If the 
reply is YES, lines and terminals will not be disabled and a restart is attempted from the last 
checkpoint. When the user program gains control after the restart, it must determine line 
and terminal status. Data in the buffer area defined by the Communications Master Control 
Block has not been reloaded or altered. 


ITB FEATURE 

Messages transmitted using the ITB feature are broken into individually transmitted 
segments of a specified length. Message segments received using ITB are reconstructed into 
whole messages with the ITB character edited out. See the TRMDEV macro ITBSIZ= 
keyword parameter. 

MAIN FLOW OF A LOGICAL TELECOMMUNICATIONS SESSION 

The flow of a logical communications session involves the user enabling the terminal lines by 
using the ENABLE macro, causing message transfer to any from the enabled terminal by 
using the SEND or RECEIVE macro, and disabling all enabled terminals by using the 
DISABLE macro. Figure 5-1 outlines this basic flow. Before a logical communications 
session begins, the user must define in his constant area one TERMINAL macro for each 


terminal or group of terminals used. 


START 
Enable 
Terminal 
Message 
Transfer 
Disable 
Terminal 


END 


Each terminal used must be defined in the user’s constant area (by a TERMINAL macro). 


Figure 5-1. Main Flow of Logical Telecommunications Session 
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TYPES OF MACROS 


Logical TCOM divides its macros into two categories. The first category consists of only the 
TERMINAL macro. The second category consists of the service request macros: ENABLE, 
DISABLE, SEND, and RECEIVE. 


Each TERMINAL macro defined in the program constructs a user terminal control block 
(UTCB) which describes the environment within which the mentioned terminals. will 
operate. This control block is used by the service request macros each time a logical 
communication operation is requested. An expansion of the UTCB and field description is 
located in Appendix E. 


Each service request macro generates a service request instruction and a parameter packet. 
When the service request is complete, the Complete bit in the parameter packet is set and 
the success of the !/O operation is reported in the Return Code field. For a complete 
description of all the fields used in the parameter packet, the user should refer to the service 
request parameter packet expansion found in Appendix G. 


DATA TRANSFER TECHNIQUES 


The logical user using service request macros may continue processing after issuing the 
service request or delay processing until the service request is complete. If he chooses to 
continue processing after issuing the service request, he may not perform any processing on 
the affected terminal until the request is completed. The user can issue the WAIT macro to 
test for a completed service request, but once the WAIT macro is issued processing stops 
until the Complete bit is set. 


SETTING OF THE COMPLETE BIT 


All transmissions to or from a remote device pass through a buffer. When data is passed to 
or received from a buffer, the Complete bit is set in the parameter packet. The number of 
buffers and the size of each buffer for a remote device is defined by the MRX/OS Control 
Language //DEFINE statement. 


IDENTIFYING THE SENDING TERMINAL 


If more than one terminal is enabled, and the terminals are in a sending condition, issuing a 
RECEIVE macro causes the contents of the first filled buffer to be transferred into the 
user’s work area. When this transfer occurs the parameter packet’s Complete bit is set. To 
identify the sending terminal the user should examine the terminal name located in the user 
work area prefix. The work area prefix is always located immediately before the receiving 
work area. For an expansion of the work area prefix, refer to Appendix F. 


IDENTIFYING THE RECEIVING TERMINAL 


When sending information to a terminal, the user must insert the name of the receiving 
terminal in the work area prefix’s terminal name field. If no message is to be transmitted, 
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but the user wishes to send a control sequence to the terminal that turns the line around, 
stops transmission, or returns the carriage and feeds paper, the user identifies the receiving 
terminal by placing the name of the receiving terminal in the UTCB prefix’s name field. 
Insertion of the terminal name must occur before issuing the SEND macro. 


ERROR REPORTING 


After the execution of each service request macro, it is the responsibility of the user to test 
the validity of the communication request. The user evaluates the condition of the 
operation by testing the bits in the parameter packet’s Return Code field. A detailed listing 


defining each bit designation in the Return Code field may be found in Appendix G. Each 
service request macro description contains a brief summary of the applicable return code bit 
designations. 


The user may determine the line and terminal status by examining the Primary and 
Secondary Status words. The Primary Status field fills at the completion of a SEND or 
RECEIVE macro and, depending on the operand selected, is located either in the work area 
prefix field or in the UTCB prefix field. The location of the Primary Status field for various 
combinations of SEND and RECEIVE operands is listed with each macro description. The 
Secondary Status word is located in the UTCB and is filled when a receive status is issued. A 
complete description of the primary and secondary status data may be found in Appendix E 
with the UTCB expansion. The primary status bits are briefly described in the discussion of 
each service request macro; the secondary status bits are briefly described in the discussion 
of the RECEIVE macro (refer to Chapter 6. Logical Communications Macros). 


LOCATING THE PARAMETER PACKET’S COMPLETE BIT AND RETURN CODE 


The user may locate the parameter packet’s Complete bit and Return Code by taking 
advantage of Logical TCOM's parameter packet labeling system. To use the label system the 
user assigns an alphanumeric label, beginning with an alphabetic character and being up to 
eight characters in length, to each service request macro designated. To all labels six 
characters or less, Logical TCOM appends two unique identifying characters. This process is 
repeated until all words except the sixth word of the parameter packet are labeled. Labels 
longer than six characters are truncated to six characters; therefore, the first six characters 
of a label should be unique. The truncated label is then appended as if it were a label of six 
characters or less. The appended characters are: SR for word one, FL for word two, CR for 
word three, OP for word four, CB for word five, and if message transfer occurs, WA for 
word seven. See Figure 5-2 for an example of this labeling system. 


The user labels a service request macro TRM3RCV. To identify the parameter packet 
word containing the Complete bit and Return Code field, the user addresses the 
TRM3RCCR storage location. 


Labels Generated 


TRM3RCOP 


TRM3RCCB UTCB Address 

TRM3RCWA Work Area or SIGNON/SIGNOFF Address 
issued without a 
SIGNON/SIGNOFF 


Figure 5-2. The Parameter Packet Labeling System — Example message. 


NOTE 


These two words 
are not included 
when ENABLE/ 
DISABLE is 


If the user does not assign a name to a service request macro, Logical TCOM will assign 
unique labels for its own use. For complete information refer to Service Request Name 
Fields in Chapter 6. Logical Communications Macros. 


COMPUTER TO TERMINAL DIALING PROCEDURES 


To make a switched connection that is initiated by the computer, the user must provide a 
routine that informs the operator of the remote user’s phone number and directs the 
Operator to dial the number. This routine must be processed after the ENABLE macro is 
issued. The ENABLE macro completes when the remote terminal answers the call. The user 
must provide an alternate processing path if the remote terminal is unable to answer the call. 


TRANSMISSION MODES 


Three transmission modes: Conversational, Send, and Receive are possible for each terminal. 
lf a terminal is in the Conversational mode, it may not be in the Send or Receive mode; 
however, a terminal not in the Conversational mode may be in the Send and/or Receive 
modes. Transmission mode is established by the CONVERS, SEND, and RECEIVE 
parameters in the TERMINAL. macro. 


In the Conversational mode, the user establishes a dialogue between the computer and the 
remote terminal with the terminal initiating the dialogue. After a line termination character 
is received, the device sending is required to receive. 


Users who wish only to send transmissions to a remote device establish a Send mode that 
ignores transmissions from the remote terminal. Likewise, users who establish a Receive 
mode are not permitted to send transmissions. If a user wishes to send and receive on a line 
but does not want to be bound by the transmission conventions established by the 
Conversational mode, he may use both the SEND and RECEIVE parameters in the 
TERMINAL macro, and initiation begins on the user’s issuance of the SEND or RECEIVE 
macro. 
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TRANSMISSION SEGMENTS 


Many times it is impossible to transmit a message with one transmission. This limitation is 
caused either by the number of printable characters that can be placed on a line, the number 
of characters that can be placed on a card, or the number of characters that can be 
transmitted to or from a terminal. Because of these limitations, messages often must be 
divided into segments and each segment is considered a complete transmission. Since each 
segment is considered a complete transmission, the user is given the option of changing the 
transmission direction at the end of any segment. Or, the user may transmit all the segments 
and change direction at the end of the message. If the user chooses to change direction at 
the end of a segment, he selects the TRANSUNIT parameter in the TERMINAL macro. If 
-he chooses to change direction at the end of the message, he selects the MESSAGE 
parameter in the TERMINAL macro. The MESSAGE and TRANSUNIT parameters are 
entries for the CONVERS, SEND, and RECEIVE operands of the TERMINAL macro. 


(All transmission segments, except the final segment, are terminated by the termination 
character designated by the TRMDEV macro’s EOU or SEOU operands. Transmissions that 
are complete messages, or the final segment of a message, must be terminated by the 
termination character designated by the TRMDEV macro’s SEOM and ENDLIST operands. 
A description of the TRMDEV macro can be found in Chapter 9. The Terminal Catalog — 
Routine.) 


Figure 5-3 shows how two messages, one from the terminal and one from the computer, 
would be handled if the TERMINAL macro’s CONVERS = MESSAGE operand were 
selected. Data transfer in this example is always initiated by the terminal. The message from 
the terminal is segmented into two complete transmissions. At the end of the second 
transmission when the computer senses an EOM termination character defined by the 
TRMDEV macro’s ENDLIST operand, line turnaround occurs and the computer responds 
with three complete transmissions followed by a message-terminating SEOM character. 


Computer Terminal 


CONVERS=MESSAGE 


Line turnaround can only occur after a complete message is sent. 


Figure 5-3. CONVERS=MESSAGE Message Transfer 


Figure 5-4 shows how two messages, each divided into three segments, are transmitted if the 
user selects the TERMINAL macro parameter, CONVE RS=TRANSUNIT. Note, in this case, 
that line turnaround occurs after each segment of a message is sent or received. 


Terminal 


CONVERS=TRANSUNIT 


Line turnaround must occur after each segment is sent. 


Figure 5-4. CONVERS=TRANSUNIT Message Transfer 


Figures 5-5 through 5-7 pictorially describe how message transfer takes place for various 
combinations of the SEND and RECEIVE operands using the MESSAGE or TRANSUNIT 
parameters in the TERMINAL macro. When in the Send and Receive mode, direction of the 
first transmission is determined by the user. 


Terminal 


SEND=MESSAGE, RECEIVE=TRANSUNIT 
Line turnaround can occur only after a complete message is sent. Messages 


received can have line turnaround after any segment (as for message B). 


Figure 5-5. SEND=MESSAGE, RECEIVE=TRANSUNIT Message Transfer 
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SEND=TRANSUNIT, RECEIVE=MESSAGE 


Line turnaround can occur only after a complete message is received. Messages 
sent can have line turnaround after any segment (as for message C). 


Figure 5-6. SEND=TRANSUNIT, RECEIVE=MESSAGE Message Transfer 


A 
| 
Terminal 


SEND=TRANSUNIT, RECEIVE=TRANSUNIT 


Line turnaround can occur after any segment of any message sent or 
received. 7 


Figure 5-7. SEND=TRANSUNIT, RECEIVE=TRANSUNIT Message Transfer 
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SYNCHRONOUS LINE INITIATION AND BIDDING PROCEDURES 


Under synchronous operation, it is possible for both the remote terminal and computer to 
simultaneously initiate data transmission or bid for the line. The Logical TCOM TERMINAL 
macro defines which device will initiate transmission or gain control of the line when these 
simultaneous conditions occur. 


Either the computer or the terminal can be designated as the initiator, and thus will initiate 
the transmission. If the computer is the initiator, the terminal is the non-initiator; if the 
terminal is the initiator the computer is the non-initiator. After line connection, the initiator 
transmits the first message. 


In a similar manner, the computer or terminal may be named as master or slave. If the 
computer is designated as the master, and simultaneous line bidding occurs, the computer 
gains line control and the terminal is considered the slave. If the terminal is designated as 
master, the computer is considered the slave. When line contention occurs, the slave always 
yields to the master. 


TERMINAL CATALOGING PROCEDURES 


All terminals must be cataloged by the Logical TCOM user in a system library. For complete 
information, refer to Chapter 9. The Terminal Catalog Routine. 


6. LOGICAL COMMUNICATIONS MACROS 


INTRODUCTION 


Logical level macros are divided into two groups. These groups deal with terminal definition 
and service request macros. Before using the material in this section, the user should be 
familiar with the information in Chapter 5. Logical Communications Programming. 


TERMINAL DEFINITION MACRO 


The TERMINAL macro constructs a user terminal control block (UTCB). This control! block 
identifies the communicating terminals, and establishes the transmission mode. The 
information defined by the TERMINAL macro is used by the service request macros each 
time a logical communications operation is performed on a terminal. The expansion of the 
TERMINAL macro (the UTCB) is located in Appendix E. 


TERMINAL — IDENTIFY TERMINALS 


| Name | Operation | eran 
| |B TERMINAL TERMNAM={ ermine 


(terminal-name,. . .terminal-name) 
A required entry specifying the symbolic name of the TERMINAL operator used by the 
ENABLE, DISABLE, SEND or RECEIVE macros. 


[,PREF1IX=prefix-name]l 

3 ,CONVERS= {TA ANSUNIT 3 
3 RECEIVE {TR ANSUNITI g 
$.SEND~{TEANSUNIT & 


caer inal 


PROMPT= { vES| ES | 


oat 
,CONTROL= | 


mos Z/< 


NAME 


OPERANDS 


TERMNAM= A required entry specifying the logical name of a terminal defined in a 
TRMDEV macro. If more than one terminal is specified, they must appear in parentheses 
separated by commas. Asynchronous and synchronous terminals may be grouped together; 
however, synchronous terminals must be grouped as master initiator, master non-initiator, 
slave initiator, or slave non-initiator terminals. 


PREFIX= An optional entry tagging the beginning storage address of the UTCB’s prefix 
status field. The data-name defining the storage address must start with an alphabetic 
character and be no longer than eight alphanumeric characters. 


One or more of the operands CONVERS, RECEIVE, or SEND must be selected. However, 
selection of the CONVERS operand prohibits the use of the other operands. 


CONVERS= This operand requires the user to send a response after receiving each message 
or transunit. The possible entries for this operand are MESSAGE or TRANSUNIT. The 
MESSAGE entry indicates that the entire message (all segments) must be sent before line 
turnaround can occur. The TRANSUNIT entry indicates that line turnaround can occur 
after any segment is sent. For a detailed discussion of messages and transunits, refer to 
Chapter 5. Logical Communications Programming. 


(Termination characters for end of unit and end of message are defined by the user in the 
TRMDEV macro ENDLIST, EOU, SEOU, and SEOM operands. The TRMDEV macro is 
discussed in Chapter 9. Terminal Catalog Routine.) 


RECEIVE= The user will receive one or more messages or transunits. The entries are 
MESSAGE or TRANSUNIT, as defined in the preceding text. 


SEND= The user will send one or more messages or transunits. The entries are MESSAGE 
or TRANSUNIT, as defined in the preceding text. 


ATTENDD= An optional entry for asynchronous terminals only. If NO is specified, the 
terminal is unattended, and it is assumed that all input is coming from the auxiliary device. 


PROMPT= An optional entry. When omitted, PROMPT=YES is assumed and_ all 
asynchronous terminal receive operations are preceded by a transmitted control character 
sequence. This sequence is derived from the FFRAME, NL, NULLS, and SEOM operands of 
the TRMDEV macro and should only be used when receiving from an asynchronous 
terminal. This operand allows the user to advance the terminal's paper and print an * on the 
new line before receiving from the terminal. 


CONTROL= An optional entry specifying whether the applications program controlling 
the synchronous terminal listed in the TERMNAM operand will be considered the master, 
slave, initiator, or non-initiator. An MI entry defines the applications program as the master 
initiator, MN as the master non-initiator, Sl as the slave initiator, and SN as the slave 
non-initiator. When this operand is omitted, Logical TCOM defaults to MI. If only 
asynchronous terminals are listed in the TERMNAM operand, Logical TCOM ignores this 
operand. 


EXPANSION STORAGE REQUIREMENTS 


The number of words required by the TERMINAL macro can be calculated from the 
following formula. 


Sw = 9+4t Where: Sw 
t 


Word storage requirements 


Number of terminal names specified 
in the TERMNAM operand 


SERVICE REQUEST MACRO INSTRUCTIONS 


The ENABLE, DISABLE, RECEIVE, and SEND macro instructions provide an interface 
between the applications program and the Logical TCOM system. These macros allow the 
user program to request service that will enable and disable a line, transfer messages, and 
report terminal status. Each service request macro generates a service request instruction and 
a parameter packet. It is the service request instruction that requests communications 
service. The parameter packet consists of a list of parameters that further describe the 
request. The expansion for the service request macros is located in Appendix G. 


SERVICE REQUEST NAME FIELD RESTRICTIONS 


The optional name entry on all service request macros performs two functions: it labels the 
address of the first instruction in the macro expansion, and uses the first six characters (or 
less if the programmer used fewer than six characters) to provide unique names for the first, 
second, third, fourth, fifth, and seventh words of the service request parameter packet. The 
name field entry must begin with an alphabetic character and be no longer than eight 
alphanumeric characters; however, the first six characters must be unique for each service 
request macro. 


If the user does not specify an entry in the name field the DISABLE, ENABLE, SEND, or 
RECEIVE macros, a label will be generated by Logical TCOM for the fields in the parameter 
packet. 


The labels will be generated as follows: 


XXYYYZZ Where: XX = $E for ENABLE 
= $D for DISABLE 
= $S for SEND 

$R for RECEIVE 


A unique 4 digit number from 0001 to 9999 


CR, FL, OP, CB, or WA depending on the field 
to be labeled 


YYYY 
ZZ 


6-3 


ENABLE — ENABLE TERMINAL 


The first ENABLE activates the logical communications initialization routines; any logical 
communications macros issued prior to the first ENABLE will be returned with an error 
code. 


The ENABLE macro also enables* one or more terminals listed in the referenced 
TERMINAL macro. The number of terminals enabled depends on the macro operands 
selected and the terminal line configuration. If each terminal listed in the referenced 
TERMINAL macro is assigned to a specific line, ENABLE connects all terminals. If more 
than one listed terminal is assigned to a switched line, the first terminal that is manually 
dialed or dials in is connected to the line. Only one terminal listed in the referenced 
TERMINAL macro is enabled if the PREFIX operand is selected. Once a terminal is 
enabled, it cannot be enabled again until it is first disabled. If a list of terminals, 
representing n lines, is enabled, all n lines are primed. After a terminal connects and then 
disconnects, the terminals that were previously candidates for connection are still candidates 
for connection (except the one that disconnected). 


Name Operation Operands 


@R 
: ‘ = n 
[label] ENOeee TERMINBE ae of TERMINAL gel 


= {NO 
[ pReFix- {Ne} 


cs data-name integer 
[.sinon ({cr, | ton. }) | 


I 
Cale 


@R, 
[uistwam= } | 
data-name 


NAME 


A required entry if LIST=YES; otherwise, an optional entry. For label restrictions, refer to 
Locating the Parameter Packet’s Complete Bit and Return Codes in Chapter 5. 


OPERANDS 


TERMNAL= A required entry specifying the name of the TERMINAL macro defining the 
user terminal control block for the terminal(s) to be enabled. A general register can be used 
to address the defining TERMINAL macro if the address is loaded into the general register 
before the ENABLE macro is issued. The name of the TERMINAL macro must begin with 
an alphabetic character and be no longer than eight alphanumeric characters. If a register 
number is specified, the number must be preceded by the symbol @. Only one TERMINAL 
macro can be specified by the TERMNAL operand. 


*ENABLE is not synonymous with connection. Dedicated lines are always connected — they must only be initialized for 
transmission. Switched lines must be primed to allow a terminal to dial in. 


PREFIX= An optional entry. When coded PREFIX=YES, this operand notifies Logical 
TCOM of the one terminal listed in the referenced TERMINAL macro that is to be enabled. 
The name of the terminal to. be enabled must be placed in the UTCB’s current terminal 
name field before issuing the ENABLE macro. When this operand is omitted, PREFIX=NO 
is assumed and one or more terminals listed tn the TERMINAL macro will be enabled. If the 
PREFIX keyword is specified for an ENABLE with LIST=YES, it must be specified for the 
complement ENABLE where LIST=NO. 


SIGNON= An optional operand used when a sign-on message is to be transmitted to the 
terminals just enabled. The data-name defines the sign-on message’s storage address, and the 
integer value represents the length of the message. The storage address must start with an 
alphabetic character and be no longer than eight alphanumeric characters. Sign-on message 
length is limited to the size of the available buffer defined by the Control Language 
//DEFINE statement BUFFER operand. General registers must be loaded with the storage 
address and message length before the macro is issued and used in place of the data-name 
and integer operands. If a register number is specified, the number must be preceded by the 
symbol @. The data in the message must be coded in line code as the sign-on message is not 
translated, edited, or framed. 


RETURN= An optional entry that allows the user to continue processing after issuing an 
ENABLE. When this operand is omitted, RETURN=NO is assumed and the user’s program 
will not receive control and must wait until the Complete bit in the parameter packet is set. 


LIST= An optional entry that specifies whether the macro expansion is to generate the ser- 
vice request and/or the parameter packet. 


lf LIST=YES, only the parameter packet is generated. Other ENABLE operand 
requirements are as follows: 


[TERMNAL=name of TERMINAL macro] 


_|NO 
| PREFIX= | YES 


_ | dataname,integer 
| SIGNON= se ] 


If there is a SIGNON message, either the SIGNON=YES or the SIGNON=dataname, integer 
operand must be used with LIST=YES because the length of the parameter packet generated 
depends on whether or not a SIGNON is present. SIGNON=YES reserves the space needed 
for the SIGNON parameter to be supplied later. SIGNON=dataname, integer actually 
supplies the values. 


lf LIST=NO, only the service request is generated. Any of the other ENABLE operands can 
be used with LIST=NO. 


lf LIST=null (no entry), both the service request and the parameter packet are generated. 
The default value for LIST is null. 


LISTNAM2= A required entry if LIST=NO is used. This operand specifies the address of the 
parameter packet associated with this service request. 
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TERMINATION CONDITIONS 
When a list of terminals is being processed, any return code other than 00746 means that 


there was an error on at least one terminal. The return code describes the error condition for 
the last terminal processed in error. 


Return Codes Description 


Norma! completion (one or more terminals are enabled). 
Terminal (s)/line not defined by Control Language. 

No output buffer available for sign-on message. 

No input buffer of sufficient size is available. 

Macro usage error. 

Exception condition. 

Not enough space available at ENABLE time. 


The terminal name asked for with //DEF 1D=xxxxxx, was not named 
in the TRMDEV macro which built the TDT descriptions on disc. 


Incorrect //DEF card in CLS. 
A terminal with an invalid 1D attempted to connect. 
Request returned early because job step in terminating sequence. 


irrecoverable Block I/O disc read error when reading SYSIN, //DEF 
tables, or the TDT descriptions from NUCLIB. 


The secondary status data can only be received by issuing a status request after the 
ENABLE operation sets its Complete bit. The Primary Status word fills after the service 
request. If the ENABLE macro enables more than one terminal, the user will have to request 
status on each terminal to test the Primary and Secondary Status words. 


EXPANSION STORAGE REQUIREMENTS 


To calculate the storage requirements, total the applicable storage quantities from the chart 
below. 


Storage 

Condition Required 

The SIGNON operand and register notation are omitted (basic request). 5 words 
The SIGNON operand is used. 2 words 
The data-name is addressed by register notation. 2 words 
The integer is addressed by register notation. 2 words 
The integer keyword is used. 4 words 
The TERMINAL macro is addressed by register notation. 2 words 
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EXAMPLE ONE — ENABLE 


The terminal to be enabled is specified in the TERMINAL macro named TRM5. A> 
120-character sign-on message will be used and is stored at location SGN5. Control returns 
to the program after the ENABLE operation is issued and before the logical enable 
operation completes. 


OPERATION OPERAND 


BTURASYES CSGNS, 129), ; 


tt 4 L 1b a ee | a se a a ee oe es a Da 


EXAMPLE TWO — ENABLE 


Three terminals called TRM6, TRM7, and TRM8 are specified in the TRM678 TERMINAL 
macro. Only TRM7 is to be enabled. The sign-on message is located in storage location 
SIGN7 and is 72 characters in length. The user chooses to wait until the enable is completed 
before continuing processing. 


OPERATION OPERAND 


fa 5 6 7 849} 10 11 12 13 14 15 16 17 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


~JENABLE [TER MNAL=TRMG7®., PREFIX=YES, 3... 
Lo. LISEGNONE CSIENT, 42). ue 


DISABLE — DISABLE TERMINAL 


DISABLE breaks the line connection to one terminal or all terminals previously enabled and 
listed in the referenced TERMINAL macro. Any transmission in process or pending at the 
time the DISABLE is requested will continue to completion. The user may omit this macro 
and allow the system to disable line connections when terminating the job step; however, 
transmissions in progress will be aborted. 


@R 
= n 
DISABLE TERMINAL. ame of TERMINAL - 


[ eer: Ge. 


_f,data-name) {integer 
/SIGNOFF= (jon, |. lon, 1] 


[,RELEASE=YES] 


NO 
,LIST=4 YES 
null 


@R 
,LISTNAM= { ] 
data-name 


[rare- {¥2.} | 


n 
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NAME 


A required entry if LIST=YES is specified; otherwise, an optional entry. For label 
restrictions refer to Locating the Parameter Packet’s Complete Bit and Return Code in 
Chapter 5. 


OPERANDS 


TERMNAL= A required entry specifying the name of the TERMINAL macro defining the 
control block listing the terminals to be disabled. A general register can be used to address 
the defining TERMINAL macro if the address is loaded into the general register before the 
DISABLE macro is issued. The name of the TERMINAL macro must begin with an 
alphabetic character and be no longer than eight alphanumeric characters. If a register 
number is specified, the symbol @ must precede the register number. 


PREFIX= An optional entry that notifies Logical TCOM that only one enabled terminal 
listed in the referenced TERMINAL macro is to be disabled. The name of the terminal to be 
disabled must be placed in the UTCB’s terminal name field before issuing the DISABLE 
macro. When this operand is omitted, PREFIX=NO is assumed and all enabled terminals 
listed in the referenced TERMINAL macro are to be disabled. If the PREFIX keyword is 
specified for a DISABLE with LIST=YES, it must be specified for the complement 
DISABLE where LIST=NO. 


SIGNOFF= An optional operand used when a sign-off message is to be transmitted to the 
terminals just before they are disabled. The data-name entry defines the storage address of 
the sign-off message and the integer entry represents the length of the message. The storage 
address must start with an alphabetic character and be no longer than eight alphanumeric 
characters. Sign-off message length is limited to the size of the available buffer defined by 
the Control Language //DEFINE statement BUFFER keyword. General registers may be 
loaded with the storage address and used in place of the data-name and integer operands. If 
a register number is specified, the symbol @ must precede the register number. The sign-off 
message data is translated to the proper line code by logical communications. 


RELEASE= An optional entry that releases terminals from the applications programs 
making the released terminal available to other partitions. 


RETURN= An optional entry that allows the user to continue processing after issuing a 
DISABLE. When this operand is omitted RETURN=YES is assumed and the user’s program 
must wait until the Complete bit in the DISABLE macro’s parameter packet sets before 
processing continues. . 


LIST= An optional entry that specifies whether the macro expansion is to generate the 
service request and/or the parameter packet. 
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If LIST=YES, only the parameter packet is generated. Any of the other DISABLE operands 
except RETURN and LISTNAM can be used with LIST=YES. If there is a SIGNON 
message, either the SIGNON=YES or the SIGNON=dataname, integer operand must be used 
with LIST=YES because the length of the parameter packet generated depends on whether 
or not a SIGNON is present. SIGNON=YES reserves the space needed for the SIGNON 
parameter to be supplied later. SIGNON=dataname, integer actually supplies the values. 


lf LIST=NO, only the service request is generated. Any of the other DISABLE operands can 
be used. 


If LIST=null (no entry), both the service request and the parameter packet are generated. 
The default value for LIST is null. 


LISTNAME= A required entry if LIST=NO is specified. This operand specifies the address of 
the parameter packet associated with this service request. 


TERMINATION CONDITIONS 


Return Codes Description 


Normal completion. 


Terminal(s)/line not defined by Control Language. 


No buffer available for sign-off message. 
Exception condition. 


Request not honored because job is in termination. 


EXPANSION STORAGE REQUIREMENTS 


To calculate the storage requirements, total the applicable storage quantities from the chart 


below. 
Storage 
Condition Required 


The SIGNOFF operand and register notation are omitted (basic request). 5 words 
The SIGNOFF operand is used. 2 words 
The date-name is addressed by register notation. 2 words 
The integer is addressed by register notation. ‘2 words 


The integer keyword is used. 4 words 


The TERMINAL macro is addressed by register notation. 2 words 


EXAMPLE ONE — DISABLE 


The terminal to be disabled is listed in the TRM5 TERMINAL macro. A 72-byte sign-off 
message is stored at location SGNF. The terminal is released from the applications program 
and control returns to the application program after the DISABLE is issued. 


OPERATION OPERAND 


TERMNAL= TRMS. SIGNOFE= CSGN TD. 5 7 
RELEASE: YES, RET TURN, YES, a 


aly bh adi ei =A. 4 a nes ame! boners 2 wa 


EXAMPLE TWO — DISABLE 


One terminal, TRMS5, listed in the TRM359 TERMINAL macro is to be disabled. Before 
issuing the DISABLE macro, terminal name TRM5 is loaded into the UTCB’s terminal name 
field. There is no sign-off message. Terminal 5 will not be released from the applications 
program, and the application program will not continue until the DISABLE is completed. 


NAME OPERATION 


OPERAND 
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RECEIVE — BUFFER TO WORK AREA 


The RECEIVE macro transfers the next available message from the memory buffer to the 
user’s work area. (The number and size of the memory buffers are defined by the Control 
Language //DEFINE statement BUFFER keyword.) If the STATUS operand is used, 
message transfer is inhibited; however, status information will appear in the designated 
terminal’s UTCB prefix field. 


Logical TCOM scans the list of terminals, returning to the beginning of the list when the end 
of the list is reached, until data is available from a terminal or until an error is detected on a 
terminal. Data is then moved into the memory buffer or an error code is posted. Scanning 
resumes with the next terminal when another RECEIVE is requested. When RECEIVE for a 
list is issued and a terminal is discovered in the scan whose next expected command is a 
SEND, the terminal will be skipped in the scan and no error will be reported. In the case of 
a single terminal operation, an error will be reported. 


@R 


RECEIVE 


A required entry if LIST=YES; otherwise, an optional entry. For label restrictions, refer to 
Locating the Parameter Packet’s Complete Bit and Return Code in Chapter 5. 


NO 
,LIST=4{ YES 
null 


@R, 
/LISTNAM= { 
data-name 


NAME 


OPERANDS 


TERMNAL= A required entry specifying the name of the TERMINAL macro defining the 
UTCB. A general register can be used to address the defining TERMINAL macro if the 
address is loaded into the general register before the RECEIVE macro is issued. The name of 
the TERMINAL macro must begin with an alphabetic character and be no longer than eight 
alphanumeric characters. If a register number is specified, the symbol! @ must precede the 
register number. 


STATUS= An optional entry. STATUS=YES requests the current operational status of a 
terminal to appear in the UTCB’s Primary and Secondary Status word fields. To request 
terminal status, the user must enter the name of the terminal that is to report status in the 
UTCB’s terminal name field before issuing the RECEIVE macro. When this operand is 
omitted or coded NO the WKAREA operand is required. 


WKAREA= Required entry when STATUS=NO. The WKAREA operand specifies a storage 
area for the received message and a six-word prefix field that is identical to the UTCB prefix 
field. This prefix field appears in the WKAREA, it always precedes the received message, 
and is updated with primary status information each time a transmission appears in the 
WKAREA. When defining the WKAREA storage field, the storage field length must be equal 
to or exceed the storage area defined by the TERMDEV macro TRANSIZ operand. To 
identify the terminal sending the message, the user must interrogate the work area’s terminal 
name field after the request is completed. The data-name address must start with an 
alphabetic character and be no longer than eight alphanumeric characters. If a register 
number specifies the address, the symbol @ must precede the register number. When this 
operand is omitted the STATUS operand must be coded YES. 
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RETURN= An optional entry that allows the user to continue processing after issuing the 
RECEIVE macro. If this operand is omitted or coded NO, the user’s program must wait 
until the Complete bit is set in the RECEIVE macro’s parameter packet before processing 
continues. 


PREFIX= An optional entry. If PREFIX=YES is specified, a single terminal operation is 
being requested and the terminal name must be in the UTCB prefix current terminal name 
field. PREFIX=NO is assumed if the operand is omitted. If PREFIX is specified, it must be 
used both with LIST=YES and LIST=NO. 


LIST= An optional entry that specifies whether the macro expansion is to generate the ser- 
vice request and/or the parameter packet. 


If LIST=YES, only the parameter packet is generated. Other RECEIVE operands allowable 
with LIST=YES are: 


[TERMNAME=name of TERMINAL macro] 
@R 
[.wkAREA=| n !] 


dataname 
_}|NO : 
| STATUS= | YES 
_}| NO 
| PREFIX=| YES 
,LIST=YES 


If LIST=NO, only the service request is generated. All of the RECEIVE operands except 
STATUS can be used with LIST=NO. 


if LIST=null (no entry), both the service request and the parameter packet are generated. 
The default value for LIST is null. 


LISTNAM= A required entry if LIST=NO is used. This operand specifies the address of the 
parameter packet associated with the service request. 


TERMINATION CONDITIONS 


Return Codes Description 


Normal completion. 
Terminal (s)/ine not defined by Control Language. 
Terminal disabled. 

Macro usage error. 

Exception condition. 

BREAK or RVI received. 

Request not honored because job is in termination. 
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Primary Status Word 
Bit Number Description 


Reserved. 


Transparent message received. 


Reserved. 


If O — EOU received 
If 1 — EOM received 


Software time-out. 
No termination character received. 
BREAK or RVI received. 


Transmission error. (The message will not be 
translated or edited.) 


Modem error. 
Line disconnected. 
Hardware lost data. 


Hardware time-out (synchronous only). 


EXPANSION STORAGE REQUIREMENTS 


To calculate the storage requirements for the RECEIVE macro, total the applicable storage 
quantities from the chart below. 


Storage 
Condition Requirements 


The STATUS operand is selected and register notation omitted. 5 words 


WKAREA operand is selected. 2 words 


Data-name is addressed by register notation. 2 words 


The terminal macro is addressed by register notation. 2 words 


REMARKS 


When a RECEIVE macro requesting status transfers status to the UTCB’s Primary and 
Secondary Status fields, the status data refers to the hardware conditions of the terminal 
and the line at the time the receive status request is granted. The Primary Status word 
received at the completion of a receive data request, and residing in the work area prefix, 
refers to the hardware conditions of the terminal and line when the message residing in the 
work area was transferred from the terminal to the buffer. 


The Secondary Status word, located in the UTCB, fills only after a STATUS=YES 
RECEIVE macro is issued. A brief description of the Secondary Status word bit designa- 
tions is listed in following text. Appendix E contains an expanded description of the 
secondary status word. 
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Secondary Status Word 


Bit Number Description 
0 Terminal physically enabled. 
1 Terminal logically enabled. 
2 Terminal RECEIVE in progress. 
3 Terminal SEND in progress. 
4 Reserved. 
5 Set when DISABLE is requested. 
6 A RECEIVE just completed on the terminal specified in the 
UTCB prefix. 
7 All output data queued for this terminal has been transmitted. 
8-11 Reserved. 
12-15 Terminal device type. 


B‘0001’ — Memorex terminal, not write only 
B’0010’ — TTY 33, 35, 37, or 38 (ASR or KSR). 


B‘0011’ — Any synchronous processor that uses the line 
control specified in Appendix H. 


B‘0101’ — Memorex write only terminal. 


EXAMPLE ONE — RECEIVE 


Terminal 6 in the TRM678 TERMINAL macro is to be used. The user wants to check the 
status of terminal 6 before issuing a RECEIVE macro. The name of the terminal, TRM6, 
must be placed in the UTCB’s prefix terminal name field before the macro is issued. 


OPERATION OPERAND 
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EXAMPLE TWO — RECEIVE 


Assume that the status of terminal 6 was correct and the user wants to receive the first 
transmission from a buffer. Control is to be given to the user’s program after the RECEIVE 
is initiated. 


OPERATION OPERAND 


1234 5 6 7 89] 10 11 1213 14 15 16 17118[ 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43.44 45 46 47 48 49 50 
an oot ee 
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EXAMPLE THREE — RECEIVE 


Assume that terminal 8 in the TRM678 TERMINAL macro is used. The address of the 
UTCB generated by the TERMINAL macro is loaded into general register 4, and the work 
area address is loaded into general register 5. Both general registers were loaded before the 
RECEIVE macro was issued. Control returns to the applications program after a 
transmission appears in the work area. 


OPERATION 


RE.CELV.E | TERMNAL=@4,WKAREA*OS 


we Woe | 4 A cae | 4 - 4 4 


SEND — WORK AREA TO BUFFER 


The SEND macro requests the transfer of a message from the user’s work area to the buffer 
and on to the destination terminal. The user has the option of using the SEND macro to 
space one line at the terminal, to allow TCOM to turn the line discipline to receive without 
an intervening send, or to not send previously queued data. Breaks sent by the terminal 


operator are honored and manipulated by the system as described under Remarks. 


[label] 


| nome | Operation. | pwns = 


TERMNAL™\pame of TERMINAL macro] 


_{ |data-name integer 
WKAREA ({on, | lone \\)| 


*MODE= 


| > 
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2 
Oo 
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uU 
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mo 
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@R, 
LISTNAM= } | 
data-name 


NAME 


A required entry if LIST=YES; otherwise, an optional entry. For label restrictions, refer to 
Locating the Parameter Packet’s Complete Bit and Return Code in Chapter 5. 


OPERANDS 


TERMNAL= A required entry specifying the name of the TERMINAL macro defining the 
sending message’s UTCB. A general register can be used to address the defining TERMINAL 
macro if the address is loaded into the general register before the RECEIVE macro is issued. 
The name of the TERMINAL macro must begin with an alphabetic character and be no 
longer than eight alphanumeric characters. If a register number specifies the TERMINAL 
macro’s address, the symbol @ must precede the register number. 


WKAREA= An optional entry. This operand may be omitted when the MODE operand’s 
OK, STOP, or NL options are used. This operand must be used when the MODE=EOM or 
MODE=UNIT operand is used, or when the MODE operand is missing. The WKAREA 
operand specifies a storage area for the transmittable data, and a six-word prefix field that is 
identical to the UTCB’s prefix field. This prefix field is always located in the work area field 
immediately before the transmittable data, and is updated with primary status information 
each time data is transmitted from the work area. The user identifies the receiving terminal 
by inserting the terminal name in the terminal name field of the work area prefix field 
before the SEND macro is issued. The user inserts the message length in the prefix field 
length field before issuing a SEND macro. The length must never exceed the longest buffer 
size integer defined by the //DEFINE statement. 


The data-name operand must start with an alphabetic character and be no longer than eight 
alphanumeric characters. Any general registers may be used in place of the data-name 
providing the general registers are loaded with the storage address before the SEND is issued. 
When specifying register notation, the register number must be preceded by the @ symbol. 


MODE= An optional entry. When omitted or if MODE=UNIT, the system assumes the user 
has divided his message into transmission units and wishes to notify the system that the last 
message sent was any unit other than the last unit of a segmented message. 


The EOM entry specifies that the user has divided his transmissions into units and he wishes 
to notify the system that this transmission is the last or only unit of a segmented message. 
This operand is also used when messages are not segmented and the user notifies the system 
that the transmission is to be appended with an EOM control character. 


The OK entry is only used when in the Conversational mode and the user has no message to 
send but wishes to receive from the terminal. Any transmission still in the buffers because 
the previous SEND to the terminal was broken will be transmitted to the terminal before 
the line is turned around. The user must identify the name of the terminal requiring the OK 
operation by placing the terminal name in the UTCB terminal name field before the SEND 
macro is issued. | 


6-16 


The STOP entry terminates transmission to the terminal. Any buffer currently sending to a 
terminal will continue to completion. Subsequent buffers filled with data are ignored. After 
the stop is issued, the user may break the line discipline for one logical communication 
operation and issue a SEND or RECEIVE macro. The user must identify the terminal 
requiring the STOP operation by placing the terminal name in the UTCB terminal name 
field before the SEND macro is issued. 


The NL entry is only used when communicating with asynchronous terminals; this entry 
resets the carriage at the beginning of the next line. The user must identify the terminal 
requiring the NL operation by placing the terminal name in the UTCB terminal name field 
before the SEND macro is issued. The NL operation is defined by the terminal’s TRMDEV 
macro FFRAME, NEWLINE, and NULLS operands. 


The REWIND entry is used to rewind the auxiliary device (for instance, MRX 1280 tape). 


RETURN= An optional entry that allows the user to continue processing after issuing the 
SEND macro. If this operand is omitted or if RETURN=NO, the user's program must wait 
until the Complete bit is set in the SEND macro parameter packet before processing 
continues. 


TRANSPT= An optional entry. YES specifies transparent mode transmission. The default is 
NO. 


TAPE= An optional entry. YES specifies output on the auxiliary tape device. YES is 
required when operating a MRX 1280 at 120 cps; all output is directed to tape and the first 
14 lines will be printed. Logical TCOM does not null-fill these first 14 lines to guarantee 
correct minimum line lengths. The default is NO. 


LIST= An optional entry that specifies whether the macro expansion is to generate the 
service request and/or the parameter packet. 


lf LIST=YES, only the parameter packet is generated. Other SEND operands allowable with 
LIST=YES are: 


[TERMNAL=name of TERMINAL macro] 


(SB 
| WKAREA ie 


UNIT 
EOM 

OK 
STOP 

NL 
REWIND 


| tape= {NO j 


= {NO }) 
|. TRANSPT= No 
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if LIST=NO, only the service request is generated. Any of the other SEND operands, with 
the exception of TRANSPT and TAPE can be used with LIST=NO. 


if LIST=null (no entry), both the service request and the parameter packet are generated. 
The default value for LIST is null. 


LISTNAM2= A required entry if LIST=NO is specified. This operand specifies the address of 
the parameter packet associated with the service request. 


TERMINATION CONDITIONS 


Return Codes Description 


00 Normal completion. 


DO Terminal(s)/line not defined by Control Language. 


Di No buffer available for output because there are none large 
enough for this message. 


D3 Terminal disabled. 

D4 Macro usage error. 

D5 Exception condition. 

D6 BREAK or RVI received. 

D8 Not enough space at enable time. 


D9 The terminal name asked for with //DEF ID=xxxxxx, was not 


named in a TRMDEV macro which built the TDT descriptions 
on disc, 


incorrect //DEF card in CLS. 
A terminal with-an invalid 1D attempted to connect. 
Request not honored because job is in termination. 


Irrecoverable Block I/O disc read error when reading SYSIN, 
//DEF tables, or the descriptions from NUCLIB. 


Primary Status Word 


Bit Number Description 
8 Software time-out. 
10 BREAK or RVI received. 
12 Modem error. 
13 Line disconnect. 
15 Hardware time-out (synchronous only). 


At the completion of the logical SEND communication operation, the Primary Status word 
will be in the Primary Status field of the work area prefix if the WKAREA operand is used, 
or in the Primary Status field of the UTCB prefix if the WKAREA operand is omitted. 
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EXPANSION STORAGE REQUIREMENTS 


The storage requirements for the SEND macro are calculated by totaling the applicable 
storage values in the chart below. 


Storage 
Condition . Required 


Register notation and the WKAREA operand is omitted. 5 words 
WKAREA operand is used. 2 words 
Data-name is addressed by register notation. 2 words 


Integer is addressed by register notation. 2 words 


Integer keyword is used. 4 words 


TERMINAL macro is addressed by register notation. 2 words 


REMARKS 


When the TERMINAL macro defines the transmission as Send-only mode and the terminal 
user transmits a break during the transmission the current data being transmitted is 
immediately halted. 


The broken data can be retransmitted to the terminal by the terminal operator (pressing the 
BREAK key on the terminal), or by the applications programmer issuing another SEND 
macro. If a SEND macro is issued, the broken transmission will be transmitted first unless 
the SEND macro’s MODE operand equals STOP. 


When the TERMINAL macro defines the transmission modes as send and receive, or 
conversational, and the terminal user transmits a break when the processor is sending data, 
the segment being transmitted is immediately halted and considered by Logical TCOM as 
being the last segment of a segmented message. The user then has the option of issuing a 
RECEIVE for data, a RECEIVE for status, or another SEND logical communication 
operation. If a RECEIVE operation is issued, control will not return to the user until the 
RECEIVE operation completes. If a SEND operation is issued, the broken transmission 
precedes the message to be transmitted by the operation, unless the SEND macro’s MODE 
operand indicates otherwise. 


When status and return code data are reported to the user, the data recovered refers to the 
current or preceding communication operations. Delays in reporting status are caused by 
Logical TCOM service request and buffer transfer techniques. Since the user depends on the 
return code and status data to detect a break, the error might not be able to detect a break 
condition until several later logical communications operations have taken place. Messages 
sent are never queued more than one deep. 
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EXAMPLE ONE — SEND 


Terminal 3 in the TRM345 TERMINAL macro is in the Conversational mode. The user 
wishes to receive two successive transmissions from terminal 3. 


OPERANO 
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EXAMPLE TWO — SEND 


Terminal 3 in the TRM345 TERMINAL macro is in the Send mode and is ready to send the 
fourth and final message segment. The message is to be stored in the alternate work area 
defined by registers 3 and 6. Prior to issuing the macro, the user loaded register 6 with the 
storage address and register 3 with the length of the field. Control returns to the user's 
program after issuing the SEND macro. 


OPERATION OPERAND 
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7. PHYSICAL COMMUNICATIONS PROGRAMMING 


INTRODUCTION 


Physical TCOM provides the user with direct controls over the basic procedures required to 
transfer messages over the communication lines. Control is given to the user through macros 
that assign lines, reserve control block storage, request |/O service, and define the executable 
1/O command program. Additional facilities allow the user to place an executable time limit 
on any command program and halt any command program. 


The OPEN and CLOSE macros provide initialization at the physical level interface; the PCB 
(Physical Command Block) and ABORT macros generate control blocks; the EXCP macro 
(Execute Command Program) requests communications service; and the COMMAND macros 
generate the command words which comprise the command programs (such as ENABLE, 
READA, BREAK) executed by the communications driver. 


ITB SUPPORT 


ITB support allows the user to send and receive long data transmissions broken up into 
shorter blocks. Block Check Character generation increases the probability of detecting 
errors. BCCs are transmitted immediately following the ITB character. An Error Status Byte 
occupies one byte in the input buffer. The ESB has two indicators — the BCC Parity Error 
(bit O) and the Hardware Lost Data (bit 1). 


USER RESPONSIBILITY AT THE PHYSICAL LEVEL 


User responsibility at the physical level is divided into five areas. These areas deal with 
controlling the line, transferring the message, translating and editing the message, testing for 
a completed command program, and writing an error recovery procedure. 


LINE CONTROL 


Line control is performed by the OPEN, CLOSE and EXCP macros. The OPEN macro 
initializes the lines so that program can request line service, and the EXCP macro requests 
the execution of a command program on the opened lines. The request terminates when the 
command program reaches a normal or abnormal termination, or when the time limit placed 
on the command program is exhausted. The CLOSE macro releases the specified lines. 


MESSAGE TRANSFER 


Before data can be sent, the physical level user must assemble a properly framed message in 
his work area. This message must contain the necessary pad and formatting characters for 
line and remote terminal control. He must also provide message translation facilities if the 
receiving terminal does not respond to the EBCDIC code. Before data can be received, the 
user must allocate storage and determine if he wants to terminate the message when his 
buffer is full, when any termination control character is sensed, or when a select set of 
termination control characters is sensed. 
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A list of termination control characters may be found listed with the READA command 
macro description in Chapter 8. Physical Communications Macros. Message transfer occurs 
when the operating system acknowledges the request for service and executes the command 
program. 


MESSAGE EDITING 


Once the user receives a message it is his responsibility to examine the message field and edit 
the message. 


TESTING FOR A COMPLETED COMMAND PROGRAM 


The user may test for a completed command program by identifying the PCB controlling 
the command program and testing the PCB’s Complete bit for a set condition. The PCB 
expansion Is located in Appendix C. 


ERROR RECOVERY PROCEDURES 


At the physical level all error recovery routines must be written by the user. The user tests 
for transmission errors after the communications command program is completed. The test 
is performed by testing the error conditions in the PCB (Physical Command Block) for any 
error conditions. If these bytes indicate an error, the user must provide any error recovery 
routine or terminate the program. For a complete description of the termination conditions, 
refer to the PCB Return Codes and Status charts in Appendix C. 


MAIN FLOW OF A PHYSICAL TELECOMMUNICATIONS SESSION 


All physical level programs must follow a certain basic flow. The following paragraphs 
outline a basic approach a user could adopt when writing a communications prograrn. Figure 
7-1 outlines the main flow of a telecommunication session. By no means is this example 
complex, and the telecommunications user will recognize its failings. But by following this 
example and using all the telecommunications macros, the user should be able to expand 
this flow to meet his applications and system line and timing requirements. 


At the start of a session, the user must select the line he wants to service by using the OPEN 
macro. After opening the lines, he uses the EXCP macro to notify the operating system that 
his program requests the execution of a command program. The operating system then 
schedules and executes the command program. The applications programmer should 
establish the habit of disabling a line before enabling it for the first time to prevent any 
errors arising from enabling a previously enabled line. 


A non-switched line is serviced by using various combinations of the COMMAND macros 
that set, enable, read, write, and. disable the line. When establishing an asynchronous line 
connection, the SET COMMAND macro should appear before the COMMAND macros 
responsible for reading, writing, or disabling the line. When establishing synchronous 
communications, the SET COMMAND macro is omitted. The SET COMMAND macro 
conditions the ICA to the line speed, code, and parity encountered during asynchronous 
data transfer, and the ENABLE COMMAND macro establishes program connection. The 
COMMAND macros responsible for reading and writing can now transfer messages between 
the remote points. After all messages have been transferred, the connection is severed by the 
DISABLE COMMAND macro. Once a line is set, it need not be set again unless it is disabled. 


Switched-line servicing is similar to non-switched servicing. The DISABLE and, if required, 
the SET macros still appear, but the ENABLE or ANSWER macro must be used to make the 
line connection. If the user is addressing a manually dialed terminal, he issues the ENABLE 
COMMAND macro and then issues dialing instructions to the computer operator. The 
applications programmer must remember that it is his responsibility to notify the computer 
operator of the remote terminal’s phone number and provide an alternate path if the 
connection cannot be established. If he is waiting to be called, he uses the ANSWER macro. 
The connection is complete after the dialed call is answered. Message transfer and line 
disabling occur as they existed in non-switched line servicing. 


When the user is finished with the teleprocessing lines, he releases it from his control by 
using the CLOSE macro. 


Start of 
Message 
Transfer 


Set if 
Asynchronous 


Enable Answer 
or Manual Dial 
Processing 


Message 
Transfer 


Message 
Transfer 
End? 


Yes 


DISABLE 


CLOSE 


End of 
Message 
Transfer 


Figure 7-1. Main Flow of Physical Telecommunications Session 
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8. PHYSICAL COMMUNICATIONS MACROS 


INTRODUCTION 


The physical level macros are divided into four groups dealing with line initialization, service 
request, the physical command block, and teleprocessing commands. This section discusses 
these macros, shows their format, describes their termination conditions (when applicable), 
defines their storage requirements, and provides examples if necessary. 


LINE INITIALIZATION MACROS 


The line initialization macros assign lines to the user for use in his program (OPEN macro) 
and release lines from his program (CLOSE macro). 


OPEN — OPEN LINE 


The OPEN macro opens one line for processing; requests for line service cannot be honored 


until the line is opened. 


ia ae —— 


jOTYP=P 

,BUFADR=symbolic 
An optional alphanumeric name. The first character of the name must be alphabetic, and 
the name cannot be longer than eight alphanumeric characters. 


address 


NAME 


OPERANDS 


IDENT= Specifies the line identifier as specified by the IDENT= operand of the MRX/OS 
Control Language //DEFINE statement. 


IOTYP=P_ A required entry specifying physical-level line interface. 
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BUFADR= A required entry specifying an area in which information about the line (the 
unit ordinal) is to be returned. 
TERMINATION CONDITIONS 
Program termination may result from any one of the following conditions. 
ts No //DEFINE statement in Control Language matching this IDENT. 
2. No BUFADR specified. 


3. Request completed normally. 


EXPANSION STORAGE REQUIREMENTS 

The OPEN macro requires four words of storage. 

REMARKS 

An expansion of this macro may be found in the MRX/OS Control Program and Data 


Management Services, Basic Reference manual. 


EXAMPLE — OPEN 


This example opens one line with the logical name L5 and inserts information about the line 
into BUFFER. 


OPERAND 


19 20 21 22 23 24 25 26 27.28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 
IDENT =LS, LOT.YP.=P. rl BUFADR= BUFFER .. 
’ ' rs , ’ ry bk Pe Sco WARN DAW TF os ares Wore oe on Bo ihe *,, Ane ac de dk 
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CLOSE — CLOSE LINE 


The CLOSE macro releases the applications program from one line previously used for 


message transfer. 


[label ] CLOSE IDENT=linename 
AOTYP=P 
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NAME 

An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight characters. 

OPERANDS 

IDENT= Specifies the logical name of the line to be closed. This name must not exceed 
eight characters and must be identical to the name used in the Control Language //DEFINE 


statement IDENT operand. 


IOTYP=P A required entry specifying physical-level line interface. 


EXPANSION STORAGE REQUIREMENTS 


The CLOSE macro requires four words of storage. 


REMARKS 

The expansion for this macro may be found in the MRX/OS Control Program and Data 
Management Services, Basic Reference manual. 

EXAMPLE — CLOSE 


This example closes the line opened in the OPEN example (see immediately preceding text). 


OPERATION OPERANOD 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47.48 49 50 
IDENT=L5,10TYP=P... |. 
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Kier piles ek Sf Ot ee deg Se ‘ 1 1 4 4 a pola ee 1 toa L 


SERVICE REQUEST MACRO 


EXCP — EXECUTE COMMAND PROGRAM 


The EXCP macro requests the execution of a telecommunications command program on an 
opened line. 
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@R,, 


pcefon 
@R, 


NO 
YES 


@R 
[,UNORD=| cress \] 


/ERRCOMP={ 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 


PCB= An optional entry specifying an address of a field whose contents identify the 
location of the PCB or ABORT macros. If omitted, the address must be in general register 
six before the request is made. Use of this operand causes the specified address to be loaded 
into general register six. The address option must start with an alphabetic character and be 
no longer than eight alphanumeric characters. Any general register containing the address 
may be used instead of the address option. The register number must be preceded by the 
symbol @. 


CP= An optional entry specifying an address of a field whose contents identify the location 
of the command program. If this entry is used, the CPADR operand in the PCB macro is 
overridden. Omit this operand if the PCB operand addresses a field that holds the address of 
the command program to be executed. The address option must start with an alphabetic 
character and be no longer than eight alphanumeric characters. Any general register except 
register six may be used instead of the address option, provided that the address is loaded 
into the register before the EXCP macro is issued. The register number must be preceded by 
the symbol @. 


RETURN= An optional entry. When coded RETURN=YES, control is returned to the 
program after I/O service is requested. When coded RETURN=NO, control is not returned 
to the program until the 1!/O operation is complete. If the operand is omitted, 
RETURN=NO is assumed. 


ERRCOMP= If coded ERRCOMP=YES and the Abnormal bit in the PCB is set, it is the 


user’s responsibility to branch to an exception processing error recovery routine. The PCB’s 
Abnormal bit is set when the command program senses an invalid command or zero byte 
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count. If this option is coded ERRCOMP=NO, the applications program terminates when 
the command program encounters an invalid command or zero byte count. If the operand is 
omitted, ERRCOMP=NO is assumed. 


UNORD= An optional entry. If coded, the unit ordinal will be properly supplied to the 
PCB before execution of the EXCP service request. The contents must have correspondence 
to the returned parameter from the OPEN macro. 


TERMINATION CONDITIONS 


If a user requests the execution of a command program or an Abort operation on a line that 
has not been opened, the Complete, Abnormal, and Return Code field addressed by the PCB 
will contain a hexadecimal CO31. If a user requests the execution of an abort operation on 
an opened line, the Complete, Abnormal, and Return Code fields of the ABORT PCB will 
contain a hexadecimal 8000. Return codes for completed command programs are listed for 
each COMMAND macro. 


EXPANSION STORAGE REQUIREMENTS 


Storage 
Keywords Selected Required 


None 1 word 


PCB=@R,, 2 words 


PCB=address 3 words 
CP=@R,, 3 words 
CP=address 4 words 
UNORD=@R,, 2 words 
UNOR D=address 3 words 


REMARKS 


The expansion for the EXCP macro can be found in the MRX/OS Control Program and Data 
Management Services, Basic Reference manual. 
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EXAMPLE ONE — EXCP 


The user program requires telecommunications I/O service on an opened line. The address of 
the PCB is EX1 and has been previously loaded into INPCB. The command program address 
is found in the PCB macro and the user elects to continue processing after the operation 
completes. The command program terminates when an invalid command or zero byte count 
is sensed. 


OPERATION OPERAND 


PCB=INPCBR.... 
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EXAMPLE TWO — EXCP 


The user program requires telecommunications !/O service on an opened line. The address of 
the PCB is EX2 and has been previously loaded into INPCB. The command program OVRD 
will override the command program referenced in the PCB macro and the address of the 
OVRD program has been loaded into INOVRD. Control is returned to the program after I/O 
service is requested. The user will write an exception processing routine. 


OPERAND 
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PCB GENERATING MACROS 


The PCB and ABORT macros are used to generate a physical command block expansion. A 
physical command block is used for all COMMAND and ABORT operations. The PCB 
macro generates a block that is seven words in length, and the ABORT macro generates a 
block that is three words in length. 


8-6 


PCB — GENERATE PHYSICAL COMMAND BLOCK 


The PCB macro generates a physical command block, the main purpose of which is to 
provide the address of the command program. This macro produces no executable code. 


| nome | opwration | operas | 


[label] [CPADR=cp-name] 
[,DEVTYP=COMM] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 

CPADR= A data-name pointing to the first COMMAND word to be executed. If this entry 
is omitted, it must appear in the EXCP macro. The data-name field must start with an 
alphabetic character and be no longer than eight alphanumeric characters. 

DEVTYP=COMM An optional entry distinguishing this PCB as a telecommunications PCB 
rather than a PCB for control of other !/O devices. Different |/O devices require varying 
sizes of status fields. If this keyword is omitted, the PCB generated will be appended with 
three unused words. 

EXPANSION STORAGE REQUIREMENTS 

The PCB macro requires seven words of storage if the DEVT YP=COMM operand is used, or 
10 words of storage if the DEVTYP operand is omitted. 


REMARKS 


The expansion for this macro can be found in Appendix C. 
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EXAMPLE — PCB 


This example constructs a PCB block for the UPDT (update) line. The CP pointer in the 
EXCP macro is omitted. The command program starts in the Name Field labeled BEGIN. 
The PCB operand in the EXCP macro points to EX1. 


OPERATION OPERAND 


ABORT — TERMINATE COMMAND PROGRAM 


The ABORT macro generates a physical command block that requests the immediate line 
termination of the command program in process. After the system grants the request, the 
system flags the physical command block as complete and processing continues. This macro 
produces no executable code. 


NAME 

An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 


(none) 


EXPANSION STORAGE REQUIREMENT 


The ABORT macro requires three words of storage. 


REMARKS 


The expansion for this macro can be found in Appendix C. The CP operand in the EXCP 
macro must be omitted when requesting an ABORT operation. 


COMMAND — TELEPROCESSING COMMAND MACROS 


Each COMMAND macro constructs one command word. All COMMAND macros have a 
mandatory entry of COMMAND in the operation field; the particular type of COMMAND 
macro is determined by the OPCODE operand. Table 8-2 summarizes information about 
COMMAND macro operations. When more than one COMMAND macro is needed to 
complete message transfer, a command program is formed. The expansion for the command 
macros can be found in Appendix D. 


USE OF THE TIMER=INTEGER OPERAND 


The TIME R=integer operand is an optional entry that can be used to place a time limit on 
the execution of one or more COMMAND words. This operand may be used with one or 
more COMMAND macros in a command program. !f a COMMAND macro omits this 
operand, TCOM does not place a time limit on the execution of the command. If the integer 
is zero, the amount of command execution time depends on the time remaining on the 
preceding command word’s timer. If the integer is any value one through nine, TCOM places 
a time limit on the execution of the command. (Refer to Table 8-1.) When a command uses 
the timer option and time-out occurs, TCOM sets the Time-Out Status bit in the PCB and 
terminates: the command program. When the SET, STATUS, CJE, CUNE, JSR, RTNJ and 
JUMP commands use the optional timer operand, timer expiration does not cause command 
program termination. However, if time-out occurs during the servicing of one of the seven 
mentioned commands, the command program terminates at the initiation of the next 
command in the command program. If the command program encounters a command using 
a reserved timer integer the command program will terminate and an invalid timer return 
code will be returned. 


Tabie 8-1. Timer Integer and Time Limits 


0 Time remaining on preceding command word's timer. 


1 second 


3 seconds 


15 seconds 
30 seconds 
60 seconds 
180 seconds 
300 seconds 
600 seconds 
1800 seconds 


ono nna fk W N 
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TERMINATION CONDITIONS 


Termination conditions are posted in bytes 2, 3, 10, and 11 of the PCB addressing the 
command program being executed. The system posts these conditions when the command 
program terminates. A complete explanation of each possible command programming 
termination is provided in the PCB Return Codes and Status Codes charts in Appendix C. 
For the reader’s convenience, a brief explanation of the possible termination conditions for 
a particular COMMAND macro is listed with each macro. 


ENABLE — CONNECT LOCAL, NON-SWITCHED, OR SWITCHED MANUAL-DIAL LINE 


This operation connects and validates the connection of a local, non-switched, or switched 
manual-dial line. * 


Name 
[label] COMMAND OPCODE=ENABLE 
-/NO 
\CHAIN= {NO 


{, TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=ENABLE A required entry specifying the executable command. 
CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


*For the current TCOM retease, ENABLE and ANSWER can be used interchangeably. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Connection established 
Abort requested 

Timer expired 

Modem error 

Invalid command 


invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The ENABLE coded COMMAND macro requires one word of storage. 


ANSWER — CONNECT SWITCHED ANSWER-ONLY LINE 


This operation enables and connects switched answer-only lines. * 


4 COMMAND OPCODE=ANSWER 


-{NO 

[:cHain={¥2. | 
[, TIMER=integer] 

An optional alphanumeric name starting with an alphabetic character and being no longer 

than eight alphanumeric characters. 


NAME 


OPERANDS 
OPCODE=ANSWER A required entry specifying the executable command. 
CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


*For the current TCOM release, ANSWER and ENABLE can be used interchangeably. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Connection established 


Abort requested 


Timer expired 


Modem error 


Invalid command 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The ANSWER coded COMMAND macro requires one word of storage. 


REMARKS 

The command may be issued in response to a RPTRING coded COMMAND macro or in 
anticipation of a ring indicator. 

EXAMPLE — ANSWER 


The receiving station will be expecting a call from a remote location in less than one minute. 
Another command is to be chained to the ANSWER coded COMMAND macro. 


OPERATION 


OPERAND 


‘123.4 5 6 7 8/9] 10 11 1213 14 15 16 171181 19 20 21 22 23 24 25 26 27.28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 
| onereerevencenssonseceemcearedien 


| ICOMMAND. | lOPCODE=ANSWER, CHALN=YES., TIMER=5 . 


a eae poeta 2 ee oe te a gh a os i ae 2 AL 


RPTRING — REPORT RING INDICATOR 


This operation reports the receipt of a ring indicator by terminating the command. 


Operation Operand 


COMMAND OPCODE=RPTRING 
[,TIMER=integer] 
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NAME 

An optional alphanumeric name starting with an alphanumeric character and being no 
longer than eight alphanumeric characters. 

OPERANDS 

OPCODE=RPTRING A required entry specifying the executable command. | 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Ring eee 


Abort reuueeted ee 


“it Timer expired, 
Invalid command 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The RPTRING ‘coded COMMAND macro requires one word of storage.’ 


EXAMPLE — RPTRING. 


ee 
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DISABLE -- DISCONNECT ANY TYPE OF LINE 


This operation disconnects and clears all types of lines. 


Operation 


OPCODE=DISABLE 
={NO 

;CHAIN (32.1 | 

[, TIMER=integer] 


[label] 


COMMAND 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=DISABLE A required entry specifying the executable command. 
CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Connection broken 
Abort requested 
Timer expired 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The DISABLE coded COMMAND macro requires one word of storage. 
REMARKS 


For switched lines, commands chained to (or requested after) a DISABLE command will be 
held for three seconds prior to execution. 
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EXAMPLE — DISABLE 


OPERATION 


OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43.44 45 46 47 48 49 50 
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JUMP — COMMAND PROGRAM JUMP TO SPECIFIED ADDRESS 


This operation causes command program execution to transfer and continue at the address 
specified. 


COMMAND OPCODE=JUMP 
,CWADR=data-name 
[, TIMER=integer] 


NAME 

An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 

OPCODE=JUMP A required entry specifying the executable command code. 


CWADR= Specifies the symbolic address of the next executable command word in the 
command program. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 2 


invalid timer ie 
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EXPANSION STORAGE REQUIREMENTS 


The JUMP coded COMMAND macro requires three words of storage. 


READA -— MOVE INCOMING DATA INTO STORAGE 


This operation causes data arriving on the line to be put in storage beginning at the address 
specified by the BUFADR operand. Control characters received by the hardware are 
- examined to see if they match the termination contro! characters appearing in Table 8-2. 
When a termination character is sensed, the command program terminates. If a termination 
control character is not recognized and the number of bytes received equals BUFSIZ, the 
READA command terminates and processing of the command program continues. When in 
the synchronous mode, all pad characters will be stripped from the received message before 
the message enters the BUFADR area if a hardware recognizable control character is 
received. Otherwise, pad characters will appear in the read message if the data read field is 
shorter than the buffer area (BUFSIZ). 


[label] COMMAND OPCODE=READA 
“BUF ADR=data-name 


,BUFSIZ=integer 
{NO 
*CHAIN= {re 
[, TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=READA A required entry specifying the executable command code. 


BUFADR= Specifies the symbolic address of the storage locations containing the received 
field. The data-name field must start with an alphabetic character and be no longer than 
eight alphanumeric characters. 


BUFSIZ= The number of storage locations reserved for the input message. The length of the 
input message cannot exceed the available storage. When using ITB, one byte must be 
allowed for each Error Status Byte* in the input buffer. 


CHAIN= An optional entry used to specify command chaining. The default is NO. 
TIMER= An optional entry; refer to Table 8-1 for integer values. 


*The ESB contains a BCC parity error indicator (bit 1) and a Hardware lost data indicator (bit 0). If one SYN character 
does not follow the BCC after !TB, the ESB will be placed in the receiving buffer following the first character of the next 
block. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Buffer exhausted 


Abort requested 


Timer expired 

Termination character received 
Intermediate BCC detected 
Software lost data 
Transmission error 

Modem error 

Line disconnect detected 
Hardware lost data 
Hardware timer expired 
Invalid command 

Zero byte count 


Invalid timer 


If the command program terminates during READA because of an ABORT request or an 
expired timer, the line will be left in receive mode. If the READA terminates because of a 
full buffer (residual byte count = 0) containing no termination characters, and there is a 
command word chained to the command program, the line will be left in Receive mode; 
otherwise, the line will be put in Transmit mode. 


Table 8-2. Termination Control Characters 


Termination 
Control 
Characters 
EOT 


ETX 


ETB/EOB 
CR 
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EXPANSION STORAGE REQUIREMENTS 


The READA coded command macro requires four words of storage. 


EXAMPLE — READA 


A message of less than 73 characters will be received and stored at address RCV. Another 
COMMAND macro appears in the command program being executed. 


OPERATION OPERAND 


(23 4-5 GF 8}9{ 10 11.12 13 14 15 16 17 19 20 21 22 23 24 26 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


OPCODE=READA, BUFADR=RCV,5........ 
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READA1* — MOVE INCOMING DATA INTO STORAGE 


This operation causes data arriving on the line to be put in storage beginning at the address 
specified by the BUFADR operand. The READA1 command operates the same as the 
READA command with the exception that an additional character, the character following 
the termination control character, is brought into storage. 


Name Operation Operand 


{label] COMMAND OPCODE=READAI1 
;BUFADR=data-name 


,~BUFSIZ=integer 


nef 


[, TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 

OPCODE=READAT1 A required entry specifying the executable command code. 

BUFADR= Specifies the symbolic address of the storage locations containing the received 


field. The data-name field must start with an alphabetic character and be no longer than 
eight alphanumeric characters. 


*Recommended for asynchronous devices. 
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BUFSIZ= The number of storage locations reserved for the input message. The length of 
the input message cannot exceed the available storage. For ITB input, one byte must be 
allowed for each Error Status Byte in the input buffer. If one SYN character does not 
follow the BCC after ITB, the ESB will be placed in the receiving buffer following the first 
character of the next block. 

CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


EXPANSION STORAGE REQUIREMENTS 


The READA1 coded COMMAND macro requires four words of storage. 


EXAMPLE — READA1 


NAME OPERATION OPERAND ~ 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


OP CODE= Fk Gi a cans sol asecolen db 
R FSIZ*13_ cies ee eee 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


| Buffer exhausted 
Abort requested 
Timer expired 
Termination character received 
Intermediate BCC detected 
Software lost data 
Transmission error 
Modem error 
Line disconnect detected 
Hardware lost data 
Hardware timer expired 


Invalid command 


Zero byte count 


invalid timer 
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If the command program terminates during READA1 because of an ABORT request or an 
expired timer, the line will be left in receive mode. If the READA1 terminates because of a 
full buffer (residual byte count = 0) containing no termination characters, and there is a 
command word chained to the command program, the line will be left in Receive mode; 
otherwise, the line will be put in Transmit mode. 


READS — MOVE INCOMING DATA INTO STORAGE 


This operation causes data arriving on the line to be put in storage beginning at the address 
specified by the BUFADR operand. Control characters received by the hardware are 
compared against the termination control characters appearing in the ENDLIST. When a 
match occurs the command program terminates. If no match occurs and the number of 
bytes received equals BUFSIZ, the READS command terminates and processing of the 
command program continues. When in the synchronous mode all pad characters will be 
stripped from the received message before the message enters the BUFADR area if a 
hardware recognizable contro! character defined by the ENDLIST operand is received. 
Otherwise, pad characters will appear in the read message if the read field is shorter than the 
buffer area (BUFSIZ). 


[label] COMMAND OPCODE=READS 
,;BUFADR=data-name 


,BUFSIZ=integer 
/ENDLIST=(xx,xx,xx,xx) 
-/NO 
CHAIN={NO 
[,TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=READS A required entry specifying the executable command. 
BUFADR= Specifies the symbolic storage address of the receiving field. The data-name 


must start with an alphabetic character and be no longer than eight alphanumeric characters. 


BUFSIZ= The number of storage locations reserved for the input message. The length of 
the input message cannot exceed the available storage. When using ITB, one byte must be 
allowed for each Error Status Byte in the input buffer. 
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ENDLIST= One to four termination contro! characters to be used as message termination 
control characters (refer to Table 8-2 in immediately preceding text). 


CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Buffer exhausted 

Abort requested 

Timer expired 

Termination character received 
Block check character detected 
Software lost data 
Transmission error 

Modem error 

Line disconnect detected 
Hardware fost data 

Hardware timer expired 

Invalid command 


Invalid timer 


Zero byte count 


EXPANSION STORAGE REQUIREMENTS 


The READS coded COMMAND macro requires six words of storage. 


EXAMPLE — READS 


An EBCDIC message of less than 161 characters will be received and stored at address RCV 1 
in less than three minutes. The message will terminate on any one of three characters 
appearing in the command terminator list. Another command appears in the command 
program being executed. 


OPERATION OPERAND 


NAME 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


ee EMRE Tere ,BUFADR=RCVI, er ere 
ENDLIST = (26,2, 3 87), » GHAINE 5 
STIMBRe4.. 2? 


12 3 45 67 8 10 11 12 13 14 15 16 17 


YES. 
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OPERANDS 
OPCODE=READS1 A required entry specifying the executable command. 


BUFADR= Specifies the symbolic storage address of the receiving field. The Gata-name 
must start with an alphabetic character and be no longer than eight alphanumeric characters. 


BUFSIZ= The number of storage locations reserved for the input message. The length of 
the input message cannot exceed the available storage. When using ITB, one byte must be 
allowed for each Error Status Byte in the input buffer. 


ENDLIST= One to four termination control characters to be used as message termination 
control characters (refer to Table 8-2 in immediately preceding text). 


CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Buffer exhausted 

Abort requested 

Timer expired 

Termination character received 
Block check character detected 
Software lost data 
Transmission error 

Modem error 

Line disconnect detected 
Hardware lost data 

Hardware timer expired 

Invalid command 

Invalid timer 


Zero byte count 
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READS1 — MOVE INCOMING DATA INTO STORAGE 


This operation causes data arriving on the line to be put in storage beginning at the address 
specified by the BUFADR operand. Control characters received by the hardware are 
compared against the termination control characters appearing in the ENDLIST. When a 
match occurs the command program terminates. One more character, in addition to the 
termination character, is brought in after the termination character. If no match occurs and 
the number of bytes received equals BUFSIZ, the READS1 command terminates and 
processing of the command program continues. When in the synchronous mode all pad 
characters will be stripped from the received message before the message enters the 
BUFADR area if a hardware recognizable control character defined by the ENDLIST 
operand is received. Otherwise, pad characters will appear in the read message if the read 
field is shorter than the buffer area (BUFSIZ). 


COMMAND OPCODE=READS1 
,BUFADR=data-name 
,BUFSIZ=integer 


JENDLIST=(xx,xx,xx,xx) 


[ cra} Fest | 


L,TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


EXPANSION STORAGE REQUIREMENTS 


The READS1 coded COMMAND macro requires six words of storage. 


EXAMPLE — READS1 


OPERAND 


FSIZ=16 ST (26, 2D, 4055 5 
CHAINSYES,tIMER#6. 
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READN — MOVE INCOMING DATA INTO STORAGE 


This operation causes data arriving on the line to be put in storage beginning at the address 
specified by the BUFADR operand. The command terminates when the number of bytes 
received equals the BUFSIZ operand. At termination, control reverts to the next command 
in the command program if one exists. 


Name Operation Operand 


—e 


label COMMAND 


OPCODE=READN 
,BUFADR=data-name 
,BUFSIZ=integer 
-{NO 
[cain (Se. 
[, TIMER=integer]} 


NAME 


An optional alphanumeric name starting with an alphanumeric character and being no 
longer than eight alphanumeric characters. 


OPERANDS 
OPCODE=READN A required entry specifying the executable COMMAND macro. 
BUFADR= A required entry specifying the storage address of the received message. The 


data-name must start with an alphabetic character and be no longer than eight alphanumeric 
characters. 


BUFSIZ= Number of storage locations reserved for the input message. The length of the 
input message cannot exceed the available storage. For 1TB input, one byte must be allowed 
for each Error Status Byte in the input buffer. 


CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Buffer exhausted 

Abort requested 

Timer expired 
Intermediate BCC detected 
Software lost data 
Transmission error 

Modem error 

Line disconnect detected 


Hardware lost data 


Hardware timer expired 


Invalid command 
Zero byte count 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The READN coded COMMAND macro requires four words of storage. 


EXAMPLE — READN 


A 120-character field of data will be received and stored in address RCV2. The message 
must arrive in less than one minute from the start of the command. Commands are chained. 


OPERATION OPERAND 


“1234567 8} 9{ 10 11 1213 14 15 16 17/18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


: CP ACT ET RCV, DURST A): 
o ena nek ae S.. 


— 4 ae ae a Ss a cs Cr oe FF 


. er ey dae, - = ib ae 4 Be a at Bi bs $i aes et es nde 


seh te eb biee E e le ol o eed Sa 


WRITE — MOVE DATA FROM STORAGE TO THE LINE 


This operation transmits the specified number of characters from the data buffer to the 
addressed communications line. All characters are treated as data characters. TCOM reports 
any breaks received during asynchronous transmission in the PCB’s status field and 
transmission continues. 
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Name Operation Operands 


[label] 


COMMAND OPCODE=WRITE 


,BUF ADR=data-name 
,BUFSIZ=integer 


=|NO 
[:cHain- | 


(, TIMER=integer] 


NAME 

An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 


OPCODE=WRITE A required entry specifying the executable command. 


BUFADRE= A required entry specifying the storage address of the data. The data-name must 
start with an alphabetic character and be no longer than eight alphanumeric characters. 


BUFSIZ= The number of bytes to be transmitted. The length of the transmitted message 
cannot exceed available storage. 


CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 
ee oe 0s 


Description 


Buffer exhausted 


Abort requested 


Timer expired 

Break received 

Software lost data 
Modem error 

Line disconnect detected 
Hardware lost data 
Hardware timer expired 


Invalid command 


ggsesessessesesesesesgesgs 


Byte count zero 


g28g,8s888888 88 & 
gsgsgssssseRens6 88 


8 


Invalid timer 
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EXPANSION STORAGE REQUIREMENTS 


The WRITE coded COMMAND macro requires four words of storage. 


REMARKS 


Trailing pad characters for binary synchronous equipment must be supplied by the user 
immediately following the ETB or ETX character. 


EXAMPLE — WRITE 


Two 72-character messages appear in storage at address location XMSG. The second message 
in storage is to be transmitted. Commands in the command program are not to be chained. 


OPERATION OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


REMARKS 


Each message must be properly framed and coded in the BUFADR message area. Trailing 
pad characters for synchronous equipment must be supplied by the user immediately 
following the end frame (ETB or ETX) character. 


WRITET — MOVE DATA FROM STORAGE TO THE LINE 


This operation transmits the specified number of characters from the data buffer to the 
addressed communications line. All control characters transferred are treated as data 
characters. A break received during transmission terminates the command program before 
buffer exhaustion. 


Operation 


OPCODE=WRITET 
-BUFADR=data-name 
,BU FSIZ=integer 


Name 


[label } 


COMMAND 


[, TIMER=integer] 


8.27 


NAME 

An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 


OPCODE=WRITET A required entry specifying the executable command. 


BUFADR= A required entry specifying the storage address of the data to be transmitted. 
The data-name must start with an alphabetic character and be no longer than eight 
alphanumeric characters. 


BUFSIZ= The number of bytes to be transmitted. 


CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Buffer exhausted 


8 8 


Abort requested 


o 
oO 


Timer expired 


= 
oO 


Break received 
Software lost data 
Modem error 


Line disconnect detected 


8888 8 


Hardware lost data 
Invalid command 


Byte count zero 


8888 888 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The WRITET coded COMMAND macro requires four words of storage. 


REMARKS 


TCOM prohibits the use of this command when transmitting synchronous data. 


8-28 


WRITEC — MOVE DATA FROM STORAGE TO THE LINE 


This operation transmits data in the buffer to a synchronous communications line. Output 
characters are treated as transparent control characters; a DLE character is sent preceding 
the transmission of each character in the output buffer. 


{label ] COMMAND OPCODE=WRITEC 


,BUFADR=data-name 


,BUFSIZ=integer 
[/TIMER=integer] 


[ cHain={ 80 | | 


NAME 

An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 

OPCODE=WRITEC A required entry specifying the executable command. 

BUFADR= A required entry specifying the storage address of the data to be transmitted. 


The data-name must start with an alphabetic character and be no longer than eight 
alphanumeric characters. 


BUFSIZ= The number of bytes in the message. 
CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Buffer exhausted 00 00 
Abort requested oo 80 
Timer expired 00 40 
Software lost data 00 04 
Modem error 00 00 
Line disconnect detected 00 00 
Hardware lost data 00 
Hardware timer expired 00 
Invalid command 00 
Byte count zero 10 
Invalid timer 00 


EXPANSION STORAGE REQUIREMENTS 


The WRITEC coded COMMAND macro requires four words of storage. 


RESYN — RESYNCHRONIZATION 


This operation causes the re-establishment of character framing when the next 
synchronizing sequence is received. 


Name Operation Operand 


[label] 


COMMAND OPCODE=RESYN 


[ cvain-} 5] 


[, TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=RESYN A required entry specifying the executable command. 
CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
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TERMINATION CONDITIONS 


PCB Byte Indicators 


Description 


Abort requested 


Timer expired 

Line disconnect detected 
Invalid unit ordinal 
Invalid command 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The RESYN coded COMMAND macro requires one word of storage. 


EOTSCH — EOT SEARCH* 


This operation causes a search for an EOT character. The command completes when EOT is 
found, abort is requested, disconnect is detected, or the command times out. 


Operation Operand 


COMMAND OPCODE=EOTSCH 


[ cram} F255] 


[,TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=EOTSCH A required entry specifying the executable command. 
CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


* This command is intended for use only when the Memorex central processing unit is a tributary station on a synchronous 
multi-point line that is half-duplex or full-duplex with SYN fil! between transmissions. EOTSCH does not function 
properly on a synchronous, full-duplex, multi-point line with mark-hold between transmissions. 


8-31 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Abort requested 


Timer expired 


Line disconnect detected 
Invalid unit ordinal 
Invalid command 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The EOTSCH coded COMMAND macro requires one word of storage. 


EXAMPLE — EOTSCH 


The following example illustrates a command program that makes use of the EOTSCH 
command. EOTSCH does not work properly on a synchronous, full duplex, multi-point line 
with mark-hold between transmissions. In that case, the command sequence in brackets 
must be substituted for the first four command words. 
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NAME OPERATION OPERAND 
23 465 67 8 10 11 12 13 14 16 16 17 18 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
Te er ne oT or i a Oy 


EOTBUF _ la Reo eee ek pee a 
or....|BDD K'37FF' ee ae 
uF | BRS... SE ee Wk pis 
Q. ... - yaaa bereeeeetueseemeet 
ELECT . TY 82Fr 
SCHEOT. | OP CODE=BOTSCH, CHALN=: YES. . 
nee OPCODE: READN ,BUFSIZ=I |, BUPADR=$ 
Shoe, 3 EOTBUF+.1, ,CHAL 
| OP CODE=CJE, Riper. | BUPADRI= Be 
. E0T+1, BUFADR2= ctorbubel tlc GWADR R25 
RDADR, CHALN:.YE 


OP.CODE=JUMP, CHWADK= eoneae : 
OPCODE?.READN, BUESIZ=2,BUFADRI=3 . 
EOT, BUFADR2=EOTBUF, CWADR= RDADR, 5. 
CHAIN=YES 

OPCODE=RESYN, CHALN YES, 
OPCODE=JUMP, CWADR: RDEOT | > 
OPCODE=RESYN , CHAIN®YES. - oew 
OPCODE:READN, Bur siz=a, BUFADR=3. 
ADRBUF, CHAIN: 

OPCODE> LeJE,BUPSTZ=2,BUPADRI=; 
E0T, BUFADR=ADRBUF, CWADR=RDADR, + 
HAIN=YES | __ acs 
OPCODE:REAPN Bursizel, BUFADR=3 


Pre Dee eens Sa? Ve ny 


COMMAND. 
_.. LICOMMAND. 


COMMAND. 


td hs a | ADRBUET2 ,CHAENEY 
COMMAND | [OPCODE=CUNE, BUFST2*1 BUFADR=ENQ, 
-...... | (BUEADRZZADRBUF+Z, CWADR=SCHEOT, 3. 
ee Toes a. | ICHALNGYES. 
fe COMMAND | OPCODE=CJE, BUFSIZ=>2,BUFADRI=POLL; 
_ -...... | |) BAEADRZ= ADRBUF Janbuisnnpeuieiaaae 
on | CHAENEYES | 
ae COMMAND. | OPCOPDE=CJNE. BUFSEZ-2, BUFADRI = 
bee ecesln aan ater, ELECT, BUEABR2= “ADRBUF,,. CWADR= 5... 
sae sheccpeae He fay yareese bite SCHADR, CHAIN yi 
ELECTED| COMMAND OP.CODES PWRITE. ee eet cay 
e 
POLLED ND | (OPcoDE=wRITE.. ss stisti«i‘( «i! 


4 Le oe a a ak a ee [een ere Oe Fare rd 4. mt 4. Bead cecal hace i a eck ae be A 5 ee As aE , 4 Bally 
10 11 12 1314 15 16 17 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


Aeeed. Gabe see bo dk ad 
12345 67 8 
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CJE — COMPARE AND JUMP IF EQUAL 


The CJE operation compares up to 31 bytes of data in two fields. If the fields match, 
command execution continues at the jump address specified. If the fields do not match, 
command execution continues at the next command if command chaining has been 
specified. Execution of more than four consecutive CJE commands may result in hardware 
lost data if all the attached communications lines are transmitting simultaneously. 


Name Operation Operand 


[label] COMMAND OPCODE=CJE 
,BUFSIZ=integer 
,BUFADR1=data-name 
,BUFADR2=data-name 
;CWADR=data-name 


[ onan} 2] 


[, TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=CJE A required entry specifying the executable command. 


BUFSIZ= A required entry specifying the number of bytes in each buffer to be compared. 
This number must be < 31. 


BUFADR1= A required entry specifying the symbolic address of the beginning of the first 
field to be compared. 


BUFADR2= A required entry specifying the symbolic address of the beginning of the 
second field to be compared. 


CWADR= A required entry specifying the symbolic address of the next command to be 
executed if the two fields match. 


CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Description 2 


Invalid timer co 


EXPANSION STORAGE REQUIREMENTS 


The CJE coded COMMAND macro requires six words of storage. 


CJNE — COMPARE AND JUMP IF NOT EQUAL 


The CJNE operation compares up to 31 bytes of data in two fields. If the fields do not 
match, command execution continues at the jump address specified. If the fields do match, 
command execution continues at the next command if the chain bit is on. Execution of 
more than four consecutive CINE commands may result in hardware lost data if all the 
attached communications lines are transmitting simultaneously. 


Name Operation Operand 


[label] COMMAND OPCODE=CJNE 
,BUFSIZ=integer 
,BUFADR1=data-name 
,BUFADR2=data-name 
,CWADR=data-name 


[ Haine} ve t | 


[,TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=CJNE A required entry specifying the executable command. 


BUFSIZ= A required entry specifying the number of bytes in each buffer to .be compared. 
This number must be < 31. 


BUFADR1= A required entry specifying the symbolic address of the beginning of the first 
field to be compared. 
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BUFADR2= A required entry specifying the symbolic address of the beginning of the 
second field to be compared. 


CWADR= A required entry specifying the symbolic address of the next command to be 
executed if the two fields do not match. 


CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The CJNE coded COMMAND macro requires six words of storage. 


JSR — JUMP TO SUBROUTINE 


This operation provides the linkage for jumping to and executing a subroutine command 
program. After executing the subroutine, control can be returned to the command following 
the JSR by using the RTNJ command. JSR commands cannot be nested. 


COMMAND OPCODE=JSR 
;CWADR=data-name 
[,TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 
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OPERANDS 
OPCODE=JSR A required entry specifying the executable command. 


CWADR= A required entry specifying the symbolic address of the next command word to 
be executed (the subroutine). 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The JSR coded COMMAND macro requires three words of storage. 


RTNJ — RETURN JUMP 


This operation affects processing of the command word immediately following the JSR, 
causing the execution of the subroutine terminated by RTNJ. 


Name Operation Operand 


[label ] COMMAND OPCODE=RTNJ 
[, TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 
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OPERANDS 
OPCODE=RTNJ A required entry specifying the executable command. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


TERMINATION CONDITIONS 


PCB Byte Indications 
Le 
= 


Description 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The RTNJ coded COMMAND macro requires one word of storage. 


BREAK — TRANSMIT SPACE SIGNAL TO THE LINE 


This operation causes one continuous space of at least 200 ms to be transmitted to the 


OPCODE=BREAK 
[.cHain= Ne | 


[label] COMMAND 


YES 
{, TIMER=integer] 


NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERANDS 
OPCODE=BREAK A required entry specifying the executable command. 
CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Break transmitted 


Timer expired 


Abort requested 


Modem error 


Line Disconnect 


Invalid command 


invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The BREAK coded COMMAND macro requires one word of storage. 


RCVBRK — RECOGNIZE RECEIPT OF SPACE SIGNAL 


The RCVBRK operation recognizes the arrival of a 150 ms continuous space signal. 


a 


COMMAND CODE=RCVBRK 
[, TIMER=integer] 
NAME 


An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 


OPERAND 
OPCODE=RCVBRK A required entry specifying the executable command. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
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TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


Abort requested 
Timer expired 
Break received 
Software lost data 
Modem error 

Line disconnect 
Hardware lost data 


Invalid command 


88ss88 8S 8B 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The RCVBRK coded COMMAND macro requires one word of storage. 


SET — CONDITION ICA 


This operation conditions the ICA to the line speed, code and parity used on the line during 
message transfer and can be issued at any time. 


Operand 


[tabel] COMMAND 


OPCODE=SET 
110 

150 

,SPEED=4 300 
600 


ASCNO 
ASCEVEN 


{LINECOD=\7 2 =o 


(|, TIMER=integer] 


[ ceuxmir=| ae t | 
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NAME 

An optional alphanumeric name starting with an alphabetic character and being no longer 
than eight alphanumeric characters. 

OPERANDS 

OPCODES=SET A required entry specifying the executable command. 


SPEED= An optional entry specifying the BPS transfer rate. When omitted, the line 
defaults to 110 if the line can operate at 110, or 600 if it cannot. 


LINECOD= An optional entry specifying the message line code and parity. ASCNO 
symbolizes the USASCII code without parity. ASCEVEN symbolizes the USASCII code 
with even parity. ASCODD symbolizes the USASCII code with odd parity. EBCDIC 
symbolizes the EBCDIC code without parity. If no entry is made, system defaults to 
ASCEVEN. 

CHAIN= An optional entry used to specify command chaining. The default is NO. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 


CPUXMIT= An optional entry specifying the channel to be used by the central processing 
unit for transmitting when operating with split soeed hardware. PRI symbolizes the primary 
channel and SEC indicates the secondary channel. The default value is PRI. 


TERMINATION CONDITIONS 


PCB Byte Indications 


Description 


SET completed 
Invalid command 


Invalid timer 


EXPANSION STORAGE REQUIREMENTS 


The SET coded COMMAND macro requires two words of storage. 
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EXAMPLE — SET 


The communications adapter must be set to an asynchronous, 600 baud, USASCII, even 
parity transmission line. Chaining is used. 


10 11 12 13 14 15 16 v7] 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43.44 45 46 47 48 49 50 
eens 


10P.CODE= SPEED*600,CODE=3...... 
SCEVEN.,C SNEG eh le 


ak fee ae ee eee: Sn es Cee Ce ta Neenal See | 4 ; epee reepey o Sanwa coven Saewrner S J, A 4. ‘ipenes vege t ik, 


OPERATION 


NAME OPERAND 


12 3-4 6k ES 


4 doe eee a te a tk i cane! Cee I a eS 


STATUS — PLACE LINE STATUS IN STORAGE 


This operation places the hardware status in the area specified by the BUFADR operand. 


Operands 


oe 


[abel] | COMMAND 


OPCODE=STATUS 
;BUFADR=data-name 
[,TIMER=integer] 


NAME 


An alphanumeric name starting with an alphabetic character and being no longer than eight 
alphanumeric characters. 


OPERANDS 

OPCODE=STATUS A required entry specifying the executable command. 

BUFADR2= The symbolic address of the storage area containing the status word. The storage 
address must be aligned on a word boundary. The data-name must be alphanumeric starting 


with an alphabetic character and being no longer than eight alphanumeric characters. 


TIMER= An optional entry; refer to Table 8-1 for integer values. 
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STATUS WORD BIT DESIGNATIONS 


Status Word 
Bit Number Description 


Reserved. 
Block check character received. 


Block check character in error. 


Data set ready (CC) on. 


Clear to send (CB) on. 

Received line signal detector (CF) on. 

Secondary clear to send (SCB) on. 

Ring indicator (CE) on. 

Lost data because the ICA could not respond to the character rate of the line. 
During asynchronous communications no stop bit was detected. 


Reserved. 


TERMINATION CONDITIONS 


PCB Byte Indications 
00 
00 


Description 


Hardware line status returned 80 
Invalid timer co 00 


EXPANSION STORAGE REQUIREMENTS 


The STATUS coded COMMAND macro requires three words of storage. 


COMMAND CODE SUMMARY 


Table 8-3 summarizes information about COMMAND macro operations. 
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Command 


ENABLE 
ANSWER 


RPTRING 
DISABLE 
BREAK 
RCVBRK 
SET 
STATUS 
JUMP 


READA 


READA!1 


READS 


READS1 


READN 


WRITE 
WRITET 


WRITEC 


RESYN 
EOTSCH 
CJE 
CJNE 
JSR 
RTNJ 


Table-8-3. Summary of COMMAND Macros 


Function 


Establish fine connection 


Answer-complete 
switched connection 


Report ring indicator 
Break line connection 
Write break 


Report break received 


Set line speed and code 


Return line status 


Execute command word 
at address specified 


Terminate read on any 
termination character 


Terminate read 1 character 


after any termination 
character 


Terminate read on ter- 
mination character 
supplied in list 


Terminate read 1 charac- 
ter after any termination 
character in list supplied 


Terminate read on byte count 


only 


Write 


Write with termination 
on received break 


Write transparent con- 
trol characters 


Re-establish character framing 


Search for EOT 


Compare and jump if equal 


Compare and jump if not equal 


Subroutine jump 


Return from subroutine 


Command 
Word 


Length 
in Bytes 


Operation 
Code 
(Hex) 


= 
~l 


nN 


Command 
Chain* 


> 
ees << 


Switched 
or Non- 


Switched** 


Both 


Both 


Both 


Both 


Both 


Both 


Both 
Both 


Both 


Both 
Both 
Both 
Both 
Both 


*Y identifies meaningful action and N identifies meaningless action that will be ignored if indicated. 
**Choices not indicated as legal will, if specified, cause command program termination. 
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Synch 
or 
Asynch** 


Both 
Both 


Both 
Both 


Asy 
Asy 
Asy 
Both 
Both 


Both 


Both 


Both 


Both 


Both 


Both 
Asy 


Syn 


Syn 
Syn 
Both 
Both 
Both 
Both 


9. THE TERMINAL CATALOG ROUTINE 


INTRODUCTION 


The Terminal Catalog routine is a program under control of the operating system that the 
logical-level programmer must use to define terminals to the system. This routine is 
independent of system generation, so that terminal definitions may be changed without 
regenerating the system. 


TERMINAL CATALOG EXECUTION 


The logical-level user defines his terminals to the Terminal Catalog routine by the 
TERMDEV macro. This macro defines the terminal name, device type, line speed, and 
other pertinent information. The source-level macros are assembled and inserted into the job 
stream explained in the following text. 


if terminals are added to the system, the user must redefine all current terminals to 
Terminal Catalog, in addition to defining the new ones. Likewise, if terminals are deleted, 
the entire set of terminal definitions must be processed by terminal catalog, minus the 
definitions to be dropped. 

CONTROL LANGUAGE FOR TERMINAL CATALOG 

The TRMDEV macros are to be coded as discussed above. The source deck is then to be 
inserted in the job stream exhibited below which when executed will place the terminal 
descriptions in $NUCLIB. 

//JOB NAME=JOBNAME 


//EXEC PGM=ASM 


//PAR OMEM1=TPTDTO,OMEM2=$T EMPCRD,OBJECT=YES 

//DEF ID=INPUT,.DEV=SYSCRD 

//DEF ID=LIST,DEV=PRINTER 

//DEF |1D=OUTPUT1,FIL=$TEMPOBJ,STA=T,DEV=DISC,NUM=500,SIZ=256,BLK=1,CSD=NO, 
// CON=YES 

//DEF {D=OUTPUT2,FIL=$TEMPCRD,STA=T,DEV=DISC,NUM=500,S!1Z=80,BLK=1, 

// CSD=NO 


//EXEC PGM=$TPDIRG 
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//DEF 


//DEF 
HE 


//DEF 
// 


//EXEC 


//PAR 


//DEF 


//DEF 


//DEF 


//DEF 


//EXEC 


/IPAR 


//DEF 


//DEF 


//DEF 


//DEF 


//DEF 


IIDATA 
TPTDTO 


1 is 
//EOS 


ID=OUT2,FIL=$TEMPCRD,STA=T,DEV=DISC 


ID=BLDRES,FIL=$TEMPBLD,STA=T,DEV=DISC,NUM=500,S!1Z=80,BLK=1, 
CSD=YES,CON=YES 


ID=SEGCARD,FIL=$TEMPSEG,STA=T,DEV=DISC,NUM=200,SIZ=80,BLK=1, 
CSD=YES,CON=YES 


PGM=LINKEDT 
PGM=TPTDTO,LST=XREF,LSD=NO,ORG='0’,SRH=NO 
ID=LIST,DEV=PRINTER 

ID=INPUT,FIL=$T EMPOBJ,STA=T,DEV=DISC 
ID=DIR,FIL=$TEMPSEG,STA=T,DEV=DISC 
ID=OUTPUT,FIL=$OSRSDNTLIBt STA=(P,0), DEV=DISC,CAT=NO,VOL=system volumet 
PGM=$BLDRES 

DEVADDR=00* ,FULLGEN=NO,STNDLOC=YES[,LISTDIR=NO] 
ID=INPUT1,FIL=$OSRSDNTLIBT,STA=(P,0), VOL=system volumet 
ID=INPUT2,FIL=$MSGLIBINPUT,STA=P,VOL=system volume t 
ID=DRECTVES,FIL=$TEMPBLD,DEV=DISC,STA=T 
ID=LIST,DEV=PRINTER 

ID=OBJLIB,FIL=$TEMPOBJ,STA=T, VOL=DISC 


FIL=SYSCRD 
CSECT 


TRMDEV statements 


END 


tThe two file names used above and listed below should be changed to conform to each installation. $OSRSDNTLIB 
should be replaced by the name of the file which contains all the load modules — the load module library. System volume 
should be the volume name of the disc pack which contains $NUCLIB. 

*This assumes that the catalog will be placed on the running system. 


TRMDEV — TERMINAL CATALOG MACRO 


This macro provides the keywords that describe terminal characteristics. One terminal may 
be described more than once providing each description is listed under a new logical name. 


Name Operation Operands 
M1240 
MRX 
terminal name TRMDEV DEVICE=¢ MRXW/O 


TTYKSR 
TTY 
SYN 


[ t= ty -22 characters. . 


ASCNO 
ASCEVEN 
ASCODD 
EBCDIC 

110 

150 

300 

600 


ALL 
»“ENDLIST= 4 NONE 


X'XXXXXXXX" 
, TRANSIZ=integer 
/LINETYP=X’xx’ 
j;EQU=X'xx’ 
SEQU=X’xxxx’ 
SEOM=X'xxxx’ 
»~FFRAME=X’'xxxx’ 
{, NULLS=integer] 
[,PAD=X’xx'] 


,LINECOD= 


*SPEED= 


CNKTIME= 


,RCVTIME= 


0 
1 
¥ 2 
3 
4 
5 
6 
7 
8 
9 
0 
1 
2. 
3 
4 
5 
6 
7 
8 
9 


[,NEWLINE=X’xxxx’] 
[,RETRIES=integer] 
[,ITBSIZ=integer] 


[ ure Yes} | 


|, TAPE=X’wwxxyyyyzzzz'] 


_ (YES 
[ trnsat-} ES {| 
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NAME 


A required entry designating the logical name of the terminal being cataloged. The logical 
name of the terminal must be an alphanumeric name starting with an alphabetic character 
and being no longer than eight alphanumeric characters. 


OPERANDS 


DEVICE= A required entry specifying one of the following |/O devices: 


6 M1240 

— Memorex terminal — not write only 
@ MRX 
© MRX w/o Memorex terminal — write only 


© TTYKS Bl 
- Teletype 33 , 35, 37, or 38 (ASR or KSR) 
o TTY § 


e SYN — Any synchronous processor or terminal that uses the line 
control defined in Appendix H. 


ID= An optional entry. From 1 to 22 characters are used by Logical TCOM to validate a 
terminal connection. When omitted, the system performs no ID validation. If the input 
terminal transmits in EBCDIC, the ID must be in character format. If the terminal transmits 
in USASCII, the ID must be in the hexadecimal format of USASCII characters. 


LINECOD= An optional entry specifying the line transmission code for the terminal. The 
line codes are: 


e ASCNO — USASCII code with no parity bit 
e ASCEVEN — USASCII code with even parity 
s ASCODD — USASCII code with odd parity 
® EBCDIC — 8-level EBCDIC code 
If the defined terminal is asynchronous and this operand is omitted, ASCEVEN is assumed. 


On the other hand, if the defined terminal is synchronous and the operand is omitted, 
EBCDIC is assumed. 
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SPEED= An optional entry. Specifies the bps rate of the terminal. Entries for this 
parameter must be 110, 150, 300, or 600. If this operand is omitted, the rate defaults to 
110 if the equipment can operate at that speed and 600 if it cannot. 


ENDLIST= An optional entry used to define asynchronous received termination characters. 
When the terminal being defined is synchronous, this operand is ignored and the ENO, ETB, 
ETX, and EOT termination characters are assumed by Logical TCOM. Under asynchronous 
operation, the user has the option of terminating a received message when any termination 
character appearing in the following table is received, when the number of text characters 
received equals the integer specified by the TRANSIZ operand, or when any one of the one 
to four termination characters selected by the user from the table is received. 


Termination 
Control! Characters EBCDIC ASCII 


lf the user wishes to terminate a message on the receipt of any termination character, he 
selects the ALL option or omits the ENDLIST operand. If the user wishes to terminate the 
input message when the number of received text characters equals the integer specified by 
the TRANSI!Z operand, he selects the NONE operand. When the user specifies any one of 
one to four termination characters to terminate a received message, he selects the 
X'XXXXXXXxX’ Option. The X‘xxxxxxxx’ option allows the user to list the hexadecimal 
representation of up to four termination characters. If fewer than four termination 
characters are selected, they must be left-justified in the field with the remaining positions 
filled with nulls. 


TRANSIZ= A required entry specifying the longest transmission that can be received by the 
computer. This integer must be large enough to include data, and control and null characters 
appearing in RECEIVE macro’s WKAREA field but not so large as to consume more storage 
than available. 


LINETYP= A required entry from the Modem/Line Type column in Table 2-2. The line 
type entry describes the hardware line connection for the terminal. Placement of one 
control character may be right- or left-justified in the field. 
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EOU= A required entry for asynchronous lines specifying the line code, in hexadecimal, of 
the termination character for received TRANSUNITS. The character specified must be one 
of the characters designated by the ENDLIST operand. This operand may be omitted when 
describing a synchronous terminal since Logical TCOM assumes an ETB character for 
TRANSUNIT termination. 


SEOU= A required entry for asynchronous terminals representing a maximum of two 
termination characters used to terminate a computer to asynchronous terminal 
TRANSUNIT. All control characters must appear in the proper line code in hexadecimal in 
the field. If only one character is used, the remaining character position should be filled 
with X’FF’. Placement of one control character may be right- or left-justified in the field. 
This operand may be omitted when describing a synchronous terminal, since Logical TCOM 
assumes an ETB character for TRANSUNIT termination. 


SEOM= A required entry for asynchronous terminals representing a maximum of two 
characters that will be used to terminate a message transmission from a terminal. All control 
characters must appear in the proper line code in hexadecimal in the field. If only one 
character is used, the remaining character position should be filled with X’FF’. Placement of 
one control character may be right- or left-justified in the field. This operand may be 
omitted when describing synchronous terminals, since Logical TCOM assumes an ETX 
character for MESSAGE termination. 


FFRAME=- A required entry for asynchronous lines representing a maximum of two 
control characters used to precede any transmission to the terminal. All control characters 
must appear in the proper line code in hexadecimal in the field. If only one character is 
used, the remaining character position should be filled with X’FF’. Placement of one control 
character may be right- or left-justified in the field. This operand is omitted for synchronous 
data transmission. 


NULLS= An optional integer value ranging from 1 to 99 specifying the number of null 
characters to be inserted in the message at transmission time. TTY terminals require one null 
to follow the NEWLINE characters in a transmission. MRX terminals have individual 
requirements for the minimum number of characters in a transmission. 


Characters Required 


MRX Terminal 


The default is 1 for TTY’s, or a TCOM calculated character count for the terminal based on 
a 96-character belt. 


This operand is omitted if the terminal is synchronous, or the asynchronous terminal does 
not require null characters. 


PAD= An optional entry specifying the pad character’s hexadecimal representation. This 
entry must be omitted when using asynchronous terminals. 


CNKTIME= An optional entry specifying the timer to be used in waiting for the terminal to 
connect to. The keyword entries range from O to 9. The time periods range from 1 second 
for integer one to 1800 seconds for integer nine. (See the integer definition chart below.) If 
integer O is used, no time limit is placed on the connection time. When this operand is 
omitted, and a switched answer terminal is being connected, no time limit is placed on the 
connection time. 


No timing 


1 second 


3 seconds 


15 seconds 
30 seconds 
60 seconds 
180 seconds 
300 seconds 
600 seconds 
1800 seconds 


onon Oo OO fF W N 


RCVTIME= An optional entry specifying the maximum period logical communications 
allows any read service request to exist without being completed. The integer values 
represent the same time periods specified in the CNKTIME operand. If this option is 
omitted and a synchronous terminal is referenced, the time period defaults to 3 seconds. 
Likewise, if an asynchronous terminal is referenced, the time period defaults to 3 minutes. 


NEWLINE= An optional entry that defines the control characters that will return the 
carriage and advance the paper one line. All contro! characters must appear in the proper 
line code in hexadecimal in the field. If only one character is needed, the remaining 
character position should be filled with X’FF’. 


RETRIES= An optional entry defining the number of times a transmission will be repeated 
if a transmission error occurs. The number of retries ranges from O to 15. If this operand is 
omitted, the number of retries defaults to 6. 


ITBSIZ= An optional entry specifying the size of each intermediate block or message 
segment containing ITB. This entry is required if ITB is to be used in transmitting to and 
from this terminal. 


LRC= An optional entry specifying that an LRC check is to be made for all transmitted 
data. . 


TAPE= A required parameter for terminals with auxiliary tape devices. The entry must be 
coded TAPE=wwxxyyyyzZzzz. 


Where: 
ww is the read initiate character 
xX is the read continue character 
YYYY is the write initiate character 


ZZZZ is the stop write character 


None of the TAPE entries can be omitted. If not applicable to a particular terminal, they 
must be coded as 00. 


For teletypes that will operate in an unattended mode, the following TAPE= entries are 
recommended: 


ww =~ X’‘11’ (DC1-Reader on) 

XX =  X’FF’ (Fill) 

yyyy =  &X'1412' (DC4-Punch off, DC2-Punch on) 
zzzz = X'1314' (DC3-Reader off, DC4-Punch off) 


TRNSLAT= An optional entry that specifies whether a message is to be translated 
(TRNSLAT=YES) or untranslated (TRNSLAT=NO). The default is YES. 
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10. OPERATOR CONSOLE COMMANDS AND MESSAGES 


The operator can use the operator console STATUS command to request the status for 
individual lines, individual terminals, all terminals, and/or all terminals and lines. 


FORMAT OF STATUS COMMAND 


The STATUS command format is: 


T STATUS {ALL, ALLL, ALLT, n, terminal name | 


One or more of the parameters can be specified in any sequence. They must be separated by 
commas and the command must be < 51 characters in length. 


PARAMETERS 


The STATUS command parameters are: 


Parameter 


terminal name 


ALL requests the status of all lines and of those terminals 


‘being used by logical TCOM. 


ALLL requests the status of all lines. 


ALLT requests the status of those terminals being used by 
logical TCOM. 


nis 1-9 or A-F and requests the status of the line specified 
by n. 


This parameter requests the status of the terminal name 
specified. This terminal name must not be ALL, ALLL, 
ALLT, or A-F. To obtain the status of a terminal with 
one of these names, the parameter ALLT or ALL must 
be used. 
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TCOM CONSOLE RESPONSES TO OPERATOR STATUS REQUESTS 


TCOM responds to a status request with one or more of the following types of message: 


o Input parameter error message 
o Line status message 
e Terminal status message 


INPUT PARAMETER ERROR MESSAGE 
STATUS command parameter error messages have the format: 


## | TPSTOO18 X. . .X 


where: 
HH indicates that no partition is assigned to the status program. 
| indicates an informative console message that does not require 
a response. 
TP indicates a telecommunications message. 
ST indicates a TCOM status message. 
001 indicates a parameter error in the STATUS command. 
8 indicates that the parameter in error was not processed. 
X...X — is replaced by a list of the parameters in error. 
LINE STATUS MESSAGES 


Line status messages issued in response to an operator STATUS command are in the format: 


## | TPSTOOOO LNE=aa, |S ypESDb PID. fy 


TYPE=bb,P|D=c,ENBL= N ; ,CMD=ee, 


TERM=terminal name \ 
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where: 


H# indicates that no partition is assigned to the status 
program. 


| indicates an informative console message that does 
not require a response. 


TP indicates a telecommunications message. 

ST indicates a TCOM status message. 

000 indicates that the message contains status informa- 
tion. 

0 indicates an informative rather than an error 
message. 

LINE=aa aa is the physical line address. 

UNASSIGNED indicates that the line is not assigned to a partition. 

TYPE=bb bb is the equipment type of the hardware. (See 

. Table 2-1 for modem/line types supported by TCOM. 
PID=c c is the partition to which this line is assigned. 
ENBL= {rt Y indicates that this line is enabled. 


N indicates that this line is not enabled. 


CMD=ee ee represents the op code of the command being 
executed at the time of the STATUS request. ee is 
00 if no command is in progress. 


TERM=terminal name terminal name is the terminal associated with the 
line if the line is physically enabled. This part of 
the message is included only for logical TCOM. 


TERMINAL STATUS MESSAGES 


Terminal status messages issued in response to an operator STATUS command are in the 
format: 


LOG TCOMM IDLE LOG ENBL 
## | TPSTOOOO Me RM=terminal name, EQP Type} PHY ENaL 
, NOT ENBL 


P| D=i,_LNE=aa,CMD=ee \ 
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where: 


TP 


ST 


LOG TCOMM IDLE 


TERM=terminal name 


EQP TYPE=h 


LOG ENBL 


PHY ENBL 


NOT ENBL 


PID=i 


LNE=aa 


CMD=ee 


indicates that no partition is assigned to the status 
program. 


indicates an informative console message that does 


not require a response. 


indicates a telecommunications message. 
indicates a TCOM status message. 


indicates that the message contains TCOM status 
information. 


indicates an informative message rather than an 
error message. 


indicates that logical TCOM is inactive. No messages 
concerning terminal status can be sent to the con- 
sole. 


terminal name is the name of the logical TCOM 
terminal. 


h is the type of terminal. 


Terminal 
Memorex terminal, not write only 
TTY 33, 35, 37, 38, ASR or KSR 


Synchronous terminal 


own a|> 


Memorex terminal, write only 
indicates that the terminal is logically enabled. 
indicates that the terminal is physically enabled. 
indicates that the terminal is not enabled. 


i specifies the partition that this terminal is 
associated with. 


aa specifies this terminal’s physical line address. 
This part of the message is included only if the 
terminal is physically enabled. 


specifies the op code of the command being 
executed at the time of the STATUS request. 
ee is OO if no command is in progress. This part 
of the message is included only if the terminal 
is physically enabled. 
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ll. TCOM CONTROL LANGUAGE STATEMENTS 


INTRODUCTION 


Control Language statements communicate information about the applications program to 
the system. The statements initiate the job, control the sequential execution of programs, 
monitor the progress of the jobs, and assign communications lines needed to complete each 
program. This section only covers those statements that assign communications lines and 
links them to terminals and logical communications buffers. This section does, however, 
show two examples of job control sequences. The first example demonstrates the statements 
used for a logical communications operation, and the second example demonstrates the 
statements used for a physical communications operation. Complete infurmation on job 
control can be found in the MRX/OS Control Language Services, Basic Reference manual. 


LOGICAL COMMUNICATIONS CONTROL STATEMENTS 


All operands defined below apply to the Control Language //DEFINE statement. The 
function of these operands is to link communications lines to terminals, assign terminals to 
the applications program, and define the storage requirements for the number of buffers 
needed for each terminal. 


ee : 
I =terminal name 


This operand specifies the terminal to be assigned to the applications programs. The name 
used must be derived from the name field of the Terminal Catalog TRMDEV macro. 


{Device} ~ . 00n) 
ym 


This operand links one terminal to one or more communications lines. The ‘’O0i,. . .,00n’’ 
option assigns a terminal to a maximum of eight lines. !f more than eight lines are linked to 
a terminal, two DEVICE statements must be used. The “i” to ‘’n’’ hexadecimal characters 
can range from 1-for the first line to F for the fifteenth line. If the MRX/40 system is used, 
the hexadecimal character cannot exceed 7 and only seven lines can be linked to one 
terminal. The “‘TPyy,m” option allows the operating system to link the terminal to one or 


more lines. The ‘‘yy”’ integer values are selected from the Modem Line Type column in 
Table 2-1, Modem/Line Type Descriptions. The Modem Line Type column describes the line 
equipment needed to support the terminal. The integer ‘‘m’’ defines the number of TPyy 
lines that will be linked to the terminal. The ‘‘m’”’ integer should never exceed the value 8 if 
the MRX/50 system is used, seven if the MRX/40 system is used, or the number of 
particular line types attached to the system. Only one non-switched line can be linked to a 
terminal. Switched calling terminals may be linked to more than one line by using the 
“OOi,...,00n’’ option or the “TPyy,m” option. Switched answer lines should only be 
linked to one or more lines by using the ‘‘O0i, .. . On” option. 


When assigning terminals to lines the following rules should be observed unless the particular 
application dictates otherwise. 


A. All terminals should operate at the same speed and with the same 
line code. 

2. Synchronous and asynchronous devices must never be assigned to the 
same line. 

cA All terminals assigned to one line should either have unique 


identification numbers or no identification numbers at all. 


BUF FER=(number,size) 


A required operand. Number and size are two integer values that specify the number of 
buffers of a given size the user would like to pool. Since the buffers are pooled, the 
BUFFER operand does not have to refer to the defined terminal. All buffers may be defined 
in one //DEFINE statement using multiple BUFFER operands or be interspersed with any 
or all of the terminal definition keywords. 


FIL=TP 


A required operand. 


EXAMPLE — LOGICAL COMMUNICATIONS CONTROL STATEMENTS 


Figure 11-1 shows the control statements for a job called LIOEX. The job contains one 
program called EX1 that transfers data to two remote terminals called TSRCV and TLRCV 
from a disc file called DSTR4. The TSRCV terminal is attached to a switched-calling 
manual-dial line and the TLRCV terminal is attached to a leased line. 


//JOB NAME=LIOEX,USER=!D005,PRIORITY=9,TYPE=1 

//EXECUTE PGM=EX1 

//DEFINE IDENT=TRSCV,DEVICE=(TP86,1),FILE=TP 

//DEFINE IDENT=TLRCV,DEVICE=007,FILE=TP 

//(DEFINE BUFFER=(2,135) 

//DEFINE IDENT=DSTR4,FILENAME=TOATA,STATUS=(P,!), VOL=18AGB2 


(Application Program) 


Figure 11-1. Logical Communications Control Statements — Example 


PHYSICAL COMMUNICATIONS CONTROL STATEMENTS © 


The physical communication Control Language statements assign communications lines to 
the user’s program. It is the responsibility of the user to control the terminals in his 
applications program. All operands apply to the //DEFINE statement. 


IDENT=line name 


A required entry that specifies the line name to be assigned to the applications program. 
This name must correspond to the IDENT entry in the operand field of the OPEN, CLOSE, 
PCB and ABORT macros. The line name must start with an alphabetic character and be no 
longer than eight alphanumeric characters. Line names shorter than eight characters are 
left-justified in the field with trailing blanks. 


DEVICE| _(00i,... Aon 
DEV ~TPyy,m 


This required operand assigns one line-name to one or more communications lines. The 
“O0i,.. .,.00n’” option assigns one terminal to n lines where n cannot exceed 8. The “i” to 
“n'” hexadecimal character can range from 1 for the first line to F for the fifteenth line. If 
the MRX/40 system is used, the hexadecimal character cannot exceed 7 and only seven lines 
can be assigned to one line-name. The ““TPyy,m” option allows the operating system to 
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assign the line-name to one or more lines. The “‘yy” integer values are selected from the 
Modem Line Type column in Table 2-1. The Modem Line Type column describes the line 
equipment needed to support the terminal. The integer ‘‘m’’ defines the number of TPyy 
lines that will be assigned to the line-name. The “’“m’’ integer should never exceed the value 
of 8 if the MRX/50 system is used, 7 if the MRX/40 system is used, or the number of 
particular line types attached to the system. Only one non-switched line can be assigned to a 
line-name. A switched-calling line-name may be assigned to more than one line by using the 
“O0i,...,00n” option or the ““TPyy,m” option. Switched answer lines should only be 
assigned to one or more line-names by using the “’OOi, . . . .0On”’ option. 


When assigning terminals to lines the following rules should be observed unless the particular 
application dictates otherwise. 


1. All terminals should operate at the same speed and with the same 
line code. 

2 Synchronous and asynchronous devices must never be assigned to the 
same line. 

3 All terminals assigned to one line should either have unique 


identification numbers or no identification numbers at all. 


FILE=PI0 


A required operand. 


EXAMPLE — PHYSICAL COMMUNICATIONS CONTROL STATEMENTS 


Figure 11-2 shows the control statements for a job called PIOEX. The job contains one 
program called EX2 that transfers data to a remote terminal on a line called TRCV-from a 
disc file called DSTR3. 


//JOB NAME=PIOEX,USER=1D005,PRIORITY=8,TYPE=1 

/I/EXECUTE PGM=EX2 

//DEFINE IDENT=TRCV,DEVICE=009,FILE=P10 

//DEFINE IDENT=DSTR3,FILENAME=PTDATA,STATUS=(P,1), VOL=18AGB2 


(Application Program) 


Figure 11-2. Physical Communications Control Statements — Example 
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A. EBCDIC AND ASCII CHARACTER ASSIGNMENTS 


Table A-1. EBCDIC Character Set 


EBCDIC 
Character 


EBCDIC 
Character 


NUL 
SOH 
STX 
ETX 
PF 
HT 
LC 
DEL 
SMM 
VT 
FF 
CR 
so 
sl 
DLE 
DC1 
Dc2 
De3 
RES 
NL 
BS 
IL 
CAN 
EM 
cc 
IFS 
IGS 
IRS 
ITB (US) 
DS 
SOs 
FS 
BYP 
LF 
EOB/ETB 
ESC/PRE 
SM 
ENO 
ACK 
BEL 
SYN 
PN 
RS 
uC 
EQT 
DC4 
NAK 
SUB 
sP 


~ +R -@PH—+H-A'iFeF 


~~. JJ me 


x 


sc ctw ergvros 3 7RT TT STOaOrO aos ® 


Table A-1. EBCDIC Character Set (Continued) 


EBCDIC Hex EBCDIC 
Character Code Character 


R 
bs) 
+ 
U 
V 
W 
x 
Y 
Z 
O 
1 
2 
3 
4 
5 
6 
7 
8 
9 


o trozzZzrALr "7 TAmMAMIOONOAPN< xX 
i?) 
fo] 


Table A-2. ASCII Character Set 


ASCII 
Character 


ASCII 
Character 


CAN DOA F&F WN 


FS 
GS 
RS 


< 
> 
? 
@ 
A 
B 
Cc 
D 
E 
F 
G 
H 
| 
J 
K 
L 
M 
N 
oO 
P 
ITB(US) a 
R 
s 
T 
U 
Vv 
Ww 
Xx 
Y 
Z 
[ 
\ 
J 


Table A-2. ASCII Character Set (Continued) 


ASCII ASCII 
Character Character 


: 
$ 
t 
u 
v 
w 
x 
y 
z 
\ 

~ 


B. PHYSICAL AND LOGICAL TCOM STORAGE REQUIREMENTS 


PHYSICAL TCOM STORAGE REQUIREMENTS 


The storage requirements for Physical TCOM are outlined below. The storage used by 
Physical TCOM is added to the storage required by other system programs to determine the 
total storage required by the operating system. 


1. Basic Telecommunications Capability 


a. Physical Communications and Driver Functions 
(including operator console interface) contains: 2046 


Z: Physical Communications and Driver Routine Options 


The table below indicates the increase in storage required to support 
each line type individually. Combinations of line types are not nec- 
essarily additive; the maximum Physical TCOM storage requirement 


is 3928. 
Line Storage 
Type Increase 
80 134 
84 308 
85 456 
86 396 
88 308 
8A 396 
8C 456 
8E 544 
98 360 
9A 448 
A4 804 
Ad 804 
AG 892 
A8 660 
AA 748 
B4 934 
B5 934 
B6 1022 
B8 790 
BA 878 


3. Physical Communication Tables — Terminal/Line Dependent 


a. Line Parameter Table (LPT) — Half/Duplex with Timer 
and Dial: 80 
b. Line Address Table (LAT) — One table required for 


system physical communications: 32 


LOGICAL TCOM STORAGE REQUIREMENTS 


Logical communications requires a total of 1586 bytes. The first 768 bytes are for the root 
module, and the last 818 are for overlays. 


The formula below can be used to calculate the storage requirements for Logical TCOM. 
The storage required is comprised of tables and buffers which reside in the partition 
containing the user’s program. If the user wishes to calculate the amount of storage 
consumed by the operating system, including Logical TCOM, he must total the storage 
required for the operating system, Physical TCOM, and Logical TCOM. (Since Logical 


TCOM uses Physical TCOM to complete the communications operation, the total storage 
required by Logical TCOM must include the storage required by Physical TCOM.) 


m 
| = 34+72T+80L+ 2 [(Sj+14)Nj+8] 
i=1 
Where: 
| = The number of bytes of storage consumed. 


T = The number of terminals named in the |DENT operands of the MRX/OS 
Control Language //DEFINE statement. 


lL. = The number of lines named. This is calculated by totaling the number of 
Control Language //DEVICE statement operands. 


i = An index value ranging from one to ““m’’. 


m = The number of unique BUFFER operands defined by the Control 
Language //DEFINE statement. 


$j = The size of the buffers in the ith BUFFER keyword defined by MRX/OS 
Control Language. 


N; = The number of buffers of size S; defined by Control Language. 
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C. PHYSICAL COMMAND BLOCK 


Unit Ordinal Word Length 
ABORT 


2 Return Code 
PCB 
4 
6 Pointer to Command Program 
8 Pointer to Last Command Word Executed 
10 Status 
12 Residual Count 
Figure C-1. Physical Command Block Structure 
The fields of the PCB are defined in the following table. 
Displacement 
Byte Bits Name Description 
0-7 Unit ordinal. 
8-15 Word Length Specifies the word length of the physical command block. Physical macros have a 
word length of seven except for the ABORT macro which has a word length of 
: three. 
0 Complete Flag Set by the system when the I/O request is complete. 
1 Abnormal Flag Set by the system indicating abnormal completion of the 1/O request. When set, 
an abnormal software condition exists. 
2-15 Return Code Set by the system indicating the termination conditions. For the bit designations, 
refer to Table C-1, PCB Return Codes. 
0-2 Reserved. 
3 Abort Request Set when the ABORT macro is used. 
4-15 Reserved. 
0-15 Pointer to Set by the CPADR operand in the PCB macro or loaded by the CP operand in 
Command Program the EXCP macro. 
0-15 Pointer to Last Set by the driver upon completion of the I/O request. This block indicates the 
Command Word address of the last command word executed. 
Executed 
0-15 Status Set by the TCOM system at the completion of the 1/O request. For the bit 


designations refer to Table C-2, PCB Status. 


0-15 Residual Count Set by TCOM when the I/O request terminates. The hexadecimal count 
indicates the number of bytes remaining in the buffer. 
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Table C-1. PCB Return Codes 


Complete, 
Abnormal 
and Return 
Code Field 


Meaning Description Comments 


X‘'8000' Normal Completion The command program was Status field should be checked 


executed to completion. for additional information. 


X‘C030’ Invalid Unit Ordinal The specified unit ordinal is Status field will not be updated 


not in the system. for this request. 


X'COC2’ Invalid Command The command addressed in the 1. A data transfer command was 
last command word executed issued to a line which was not 
field of the PCB is invalid for enabled. 

either of the reasons given in 

the next column. 2. This command was issued to 
a line which is incapable of 


executing the command. 


3. A control command was 
issued to a line at an 
inappropriate time (that is, 
an ENABLE command was 
issued to an enabled line). 


Zero Byte Count The data transfer command A request to transfer zero bytes 
contained a zero count field. is invalid. 


x‘COC4’ 


x'COC6’ Invalid Timer The timer specified in the last The timer code specified has not 
command word executed field yet been assigned. 


of the PCB is invalid. 
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Status 


X‘8000' 


‘4000’ 


‘2000’ 


X‘1000' 


X‘0800' 


X‘0400' 


X’0200’ 


X'0100' 


X‘0080' 


X‘0040' 


X‘0020’ 


X‘0010' 


‘0008’ 


‘0004’ 


X‘0002' 


x‘0001' 


Abort Requested 


Timer Expired 


Termination 
Character 
Received 


BREAK Received 


Intermediate BCC 
Detected 


Software 
Lost Data 


Transmission Error 


Modem Error 


Line Disconnect 
Detected 


Reserved 


Reserved 


Ring Indicator 


Hardware Lost Data 


Hardware Timer 
Expired 


Table C-2. PCB Status 
Description 


The command program was aborted 
via the user’s request. 


The timer requested with this 
command expired. 


The communication driver detected 
a requested termination character in 
the input data. 


A break was detected on the 
addressed asynchronous line. 


A BCC status was received and 
the input buffer was not terminated. 


One or more input characters were 
received by the communication 
driver and no read command for 
this line was pending. 


No stop-bit, VRC error, or a BCC/ 


LRC error occurred on the processing 


unit receipt of data. 


A modem error was detected on the 
addressed line. 


A line disconnect was detected on 
the addressed line. 


The ring indicator was received for 
the addressed line. 


A Processing Unit overload was 
detected and the addressed line 
adapter was unable to enter the 
assembled character into the com- 
mon control (hardware) queue. 


The SYN-3 second hardware timer 
expired. 


Comments 


The command in execution is stopped 
and the communication request is 
aborted. 


The command in execution is stopped 
and the communication request is 
terminated. 


The command and the command program 
are terminated. 


*If the command in execution is a WRITET, 
execution will stop immediately. The 
execution of any other command will not be 
altered. This only applies to asynchronous 
lines. 


*The command terminated when the ter- 
mination character was received. !nput 
buffer contains ESB’s. 


*The output data transfer command in 
execution (for 103A only) or the next data 
transfer command is executed to completion. 
The command program is then terminated. 


The input command is executed to com- 
pletion and the command program is 
terminated. 


The command in execution and the command 
program is terminated upon detection of this 
condition. The user can issue a RECEIVE 
with STATUS=YES for more information. 


The command in execution and the command 
program are terminated upon detection of 
this condition. 


This status bit is set only when the RPTRING 
command is pending. The command program 
is terminated upon detection of this condition. 


*The command in execution or the next 
command issued is executed to completion 
and the command program is then 
terminated. 


*The command in execution or the next 
command to be executed will continue to 
completion. The command program will 
then be terminated. 


*These conditions can occur simultaneously with each other. Also they may occur with only one of those conditions not noted. 
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D. COMMAND WORD EXPANSIONS 


Five command word expansions are used for the COMMAND macros. In the following 
material each command is associated with the proper format, and the function of each bit in 


the format is discussed. 


READA, READA1, READN, WRITE, WRITET, AND WRITEC EXPANSION 


Figure D-1 shows the command word expansion for these COMMAND macros. 


Byte Count 


First Byte Address 


Figure D-1. Command Word Expansion One 


The fields of this expansion are defined in the following table. 


Displacement 


Encoded Timer 
Value 


Op Code 


Byte Count 


First Byte 
Address 


Description 


Set by inclusion of the CHAIN=YES operand. The CHAIN operand indicates 
that another command word follows. 


Set by inclusion of the TIMER=integer operand. 
Reserved. 


If the timer is used, this field specifies the binary value used to represent the elapse 
time. The Time Limit, Table 8-1, defines the integer values for each time limit. 


The binary equivalent of the hexadecimal delination of the operation codes 
specified for this format. The hexadecimal delineations for the COMMAND macros 
pertaining to this format are: 0346 READA, 1346 READAT1, 0By¢ READN, 
024g WRITE, 0A4g WRITEC, and 061g WRITET. 


The binary equivalent for the hexadecimal number of bytes to be transferred during 
the operation. 


Reserved. 


The binary equivalent of the hexadecimal memory address pointing to the location 
of the first byte. 
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READS AND READS1 EXPANSION 


Figure D-2 shows the command word expansion for the READS and READS1 coded 
COMMAND macros. 


0 1 2 3 4 7 8 15 


Encoded Timer Value | Op Code 


Byte Count 


First Byte Address 


Buffer Terminator 


Characters (1-4) 


Figure D-2. Command Word Expansion Two 


The fields for this expansion are defined in the following table. 


Displacement 


Description 


Set by the inclusion of the CHAIN=YES operand indicating that another command 
word follows. ; 


Set by the inclusion of the TIMER=integer operand. 


Reserved. 


If the timer is used, this field specifies the binary numeric value used to represent 
the permissible elapse time. Table 8-1 defines the integer value for each time limit. 


Encoded Timer 
Value 


The binary equivalent of the hexadecimal READS operation code 0746 or the 
READS1 operation code 1746. 


Op Code 


Byte Count The binary equivalent for the hexadecimal number of bytes to be transferred during 


the operation. 


Reserved. 


First Byte 
Address 


The binary equivalent of the hexadecimal memory address pointing to the first 
operable byte. 


Buffer 
Terminator 
Characters 


The binary equivalent of up to four termination control characters left-justified in 
the field and selected from the list of termination control characters appearing in 
Table 8-2. They must be specified in line code. 
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SET EXPANSION 


Figure D-3 shows the command word expansion for the SET COMMAND macro. 


0 1 2 3 4 7 8 15 
Oo Encoded Timer Value Op Code 
en [os Be] se 
0 8 9 10 11 12 13 15 


Figure D-3. Command Word Expansion Three 


The fields of this expansion are defined in the following table. 


Displacement 


Bits Description 


0 , (0) Set by the inclusion of the CHAIN=YES indicating that another command 
word follows. 


1 Set by the inclusion of the TIMER=integer operand. 


2-3 . Reserved. 


4-7 Encoded Timer if the timer is used, this field specifies the binary numeric value used to represent 
Value the elapsed time. Table 8-1 defines the integer value for each time limit. 


8-15 Op Code The binary equivalent of the hexadecimal SET operation code 114. 
2 0-8 Set to zero. 
9-10 . A two-bit configuration specifying the line code of the enabled line. The 
representative bit configurations are: 005 for USASCII with even parity, 015 
for USASCI! with odd parity, 105 for USASCII without parity, and 115 for 
EBCDIC. 


11 Set to zero. 


12 Set to indicate that the CPU will transmit on the primary channel. 


13-15 A three-bit configuration specifying the baud rate of the enabled line. The 
representative bit configurations are: 0115 for 1200 baud, 1005 for 600 baud, 
1015 for 300 baud, 1105 for 150 baud, and 11 15 for 1 10 baud. 
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RPTRING, ANSWER, BREAK, RCVBRK, ENABLE, DISABLE, RTNJ, EOTSCH, AND 
RESYN EXPANSION 


Figure D-4 shows the command word expansion for these COMMAND macros. 


7 8 15 
Encoded Timer Value Op Code | 


Figure D-4. Command Word Expansion Four 


The fields of this expansion are defined in the following table. 


Displacement. 


Description 


Set by inclusion of the operand CHAIN=YES indicating that another command word 
follows. RPTRING and RCVBRK must not be chained to a successor command. 


Set by the inclusion of the TIMER=integer operand. 


Reserved. 


If the timer is used, this field specifies the binary value used to represent the time 
limit. Table 8-1 shows the integer value for each time limit. 


Encoded Timer 
Value 


Op Code The binary equivalent of the hexadecimal delineation of the operation codes 
specified for the format. The hexadecimal delimeations for the COMMAND macros 
pertaining to this format are: 1946 RPTRING, 1046 ANSWER, 0946 RCVBRK, 


014g ENABLE, 054g DISABLE, 18)g RTNJ, OF 1g EOTSCH, and 15; RESYN. 


STATUS, JUMP, AND JSR EXPANSION 


Figure D-5 shows the command word expansion for the STATUS, JUMP and JSR 
COMMAND macros. 


Encoded Timer Value 


4 Address 


Figure D-5. Command Word Expansion Five 
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The fields of this expansion are defined in the following table. 


Displacement 


(0) 
Timer 
Encoded Timer 
Value 
Op Code 
2 
4 Address 


CJE AND CJNE EXPANSION 


Description 
Reserved. 
Set by inclusion of the TIMER=integer operand. 
Reserved. 


If the timer is used, this field specifies the binary numeric value to represent 
the time limit. Table 8-1 shows the integer value for each time limit. 


The binary equivalent of the hexadecimal STATUS operation code (11 16) 
JUMP operation code (084g), or JSR operation code (0C4¢). 


Reserved. 


The binary equivalent of the hexadecimal memory address pointing to the 
first storage location of the status field or branching address. 


Figure D-6 shows the command word expansion for the CJE and CINE COMMAND macros. 


0 1 2 3 
0 
2 Buffer Size 
4 
6 
8 


4 7 
Encoded 
Timer Value 


Buffer 1 Address 


Buffer 2 Address 


10 Command Word Address 


Figure D-6. Command Word Expansion 6 
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The fields of this expansion are defined in the following table. 


Displacement 


Encoded Timer 
Value 


Op Code 


Buffer Size 


Buffer 1 Address 


Buffer 2 Address 


Command Word 
Address 


Description 


Set by the inclusion of CHAIN=YES indicating that another 
command word follows. 


Set by the inclusion of the TIMER=integer operand. 

Reserved. 

if the timer is used, this field specifies the binary numeric value 
used to represent the elapsed time. Table 8-1 defines the 


integer value for each time limit. 


The binary equivalent of the hexadecimal! CJE operation code 


(1046) or CUNE operation code (14,46). 


Reserved. 

The number of bytes in each buffer to be compared. 

Reserved. 

The address of the beginning of the first field to be compared. 
The address of the beginning of the second field to be compared. 
Reserved. 


The address of the next command to be executed if the jump 
conditions are met. 


E. USER TERMINAL CONTROL BLOCK 


C4] 1 2 3 4 5 6 7 8 9 10 14 15 
o[rm] [wm] w [em] ef) | «| 
2 Secondary Status Word 
4 Primary Status Word 
6 Current Data Size 
8 
UTCB 
Prefix 
Current Terminal Name 
16 No. Terminals-1 Current Entry 
18 
First Terminal Name 
26 | | 


nth Terminal Name 


Figure E-1. User Terminal Control Block 


The fields of the UTCB are defined in the following table. 


Displacement 


Description 


TRANSUNIT/ This bit is zero when in the CONVERS mode and sending by TRANSUNIT. The 
MESSAGE bit is 1 when in the CONVERS mode and sending by MESSAGE, 


CONVERS Set when in the CONVERS mode. 


TRANSUNIT/ This bit is zero when in the RECEIVE mode and sending by TRANSUNIT. The 
MESSAGE bit is one when in the RECEIVE mode and sending by MESSAGE. 


RECEIVE Sets when in the RECEIVE only mode. 


TRANSUNIT/ This bit is zero when in the SEND mode and sending by TRANSUNIT. The 
MESSAGE bit is one when in the SEND mode and sending by MESSAGE. 
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Displacement 


I 5 
6 
7 Prompt 
| 8 
l 9 
10-14 
15 Free Bit 
2 0-15 Secondary Status 
Word 
4 0-15 Primary Status 
Word 
| 
| 


Description 
Set when in the SEND only mode. 
Reserved. 

Set when the terminal is to be prompted for read operations (asynchronous only). 
Set if terminal is master synchronous; reset if terminal is slave synchronous. 

Set if terminal will bid for line first; reset if terminal will not bid for line first. 
Reserved. 

Set if available to user; reset if in use by system. 

The bit settings listed below reflect the status of the terminal named in the current 
terminal name field. The status bits set at the completion of a logical receive status 


request, 


Bit 0: Set when the terminal is physically enabled. 


Bit 1: Set when the terminal is logically enabled. 


Bit 2: Terminal RECEIVE in progress. 
Bit 3: Terminal SEND in progress. 

Bit 4: Reserved. 

Bit 5: Set when DISABLE is requested. 


Bit 6: A RECEIVE just completed on the terminal specified in the UTCB 
prefix. 


Bit 7: All output data queued for this terminal has been transmitted. 
Bits 8-11: Reserved. 


Bits 12-15: These bits denote the type of terminal. The bit settings are 0001 
representing a Memorex read/write terminal, 0010 representing TTY 
33, 35, 37 or 38 ASR or KSR; 0011 representing a synchronous 
terminal or processor; 0101 representing a Memorex write only 
terminal. 


The bit settings listed below reflect the status of the terminal named in the current 
terminal name field. The status bits set at the completion of a logical receive status 
communications operation or a SEND macro operation using the MODE operand’s 
OK, STOP, or NL options. 


Bits 0-6: Reserved 


Bit 7: Set when an end-of-message is received at the end of a receive logical 
operation. This bit is reset when an end-of-unit is received at the end 
of a receive logical operation. 


Bit 8: Set when the CNKTIME or RCVTIME timers set by the TRMDEV macro 
expire. 


Bit 9: Set when the buffer fills without receiving a termination character. 
Bit 10: Set when a break or reverse interrupt is received. 


Bit 11: Set when a transmission error occurs. The data containing the error is 
moved to the user’s work area unedited and untranslated. 


Set when a modem error is detected. 


Displacement 


Byte 


26 


Bits 


"0-15 


0-63 


8-15 


Name 


Current Data Size 


Current Terminal 
Name 


No. Terminals-1 
Current Entry 


First Terminal! 
Name 


nth Terminal 
Name 


Description 


Set when a line disconnect occurs. 


Set when an overload causes data to be overlaid before it could be trans- 
ferred to the processing unit’s buffer. This is a hardware lost-data 
condition. 


Sets when in synchronous operation and no sync or data is received 
in three seconds. 


The number of bytes transmitted with a SIGNON or SIGNOFF message. 


The logical name of the subject terminal. 


The number of terminals named in the UTCB minus one. 
The number of the current entry in the terminal name list. 


The name of the first terminal described in the TERMINAL macro TERMNAM 
operand. 


The remainder of the terminal names described in the TERMINAL macro TERMNAM 
operand. 
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F. USER WORK AREA PREFIX 


Number of Bytes Sent or Received 


Terminal Name (1-8 Bytes) 


15 


Primary Status Word 


Figure F-1. User Work Area Prefix 


The fields in the prefix area are defined in the following table. 


Byte 


0 


Displacement 


Primary Status 
Word 


Bytes Sent or 
Received 


Terminal Name 


Description 
The bit settings listed below reflect the status of the terminal named in the terminal 
name field. The status word sets at the completion of a logical receive or send 


operation only if the user codes the RECEIVE macro WKAREA operand or SEND 
macro WKAREA operand. 


Bits 0-6: Reserved. 


Bit 7: Set when an end-of-message is received from the terminal. This bit is reset 
when an end-of-unit is received from the terminal. 


Bit 8: Set when the CNKTIME or RCVTIME timers set by the TRMDEV macro 
expire. 


Bit 9: Set when the buffer fills without receiving an EOU or EOM termination 
character. 


Bit 10: Set when a break or reverse interrupt is received. 


Bit 11: Set when a transmission error occurs. The data containing the error is 
moved to the work area unedited and untranslated. 


Bit 12: Set when a modem error is detected. 
Bit 13: Set when a line disconnect occurs, 


Bit 14: Set when an overload causes data to be overlaid before it could be trans- 
ferred to the processing unit's buffer. This is a hardware lost-data condition. 


Bit 15: Set when in synchronous operation and no sync or data is received in 
three seconds. 


Number of bytes transmitted or received. 


The logical name of the terminal receiving or sending data. 
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G. SERVICE REQUESTS PARAMETER PACKET FOR THE 
ENABLE , DISABLE, RECEIVE AND SEND MACROS 


0 1 2 3 4 7 8 15 


Service Request Instruction 


0 Op Code Packet Length in Words 
2 Cc nn Return Code 
4 


6 UTCB Address 


10 . Work Area or Sign On/Off Address 


*These two words are not included when ENABLE/DISABLE is issued without a SIGNON/SIGNOFF message. 


Figure G-1. Service Request Parameter Packet 


The fields of the parameter packet are defined in the following table. 


Displacement 


Byte Bit Description 


0 The operation codes (in hexadecimal) are as follows: 


Enable 

Enable with Sign-on 
Receive 

Send 

Send OK 

Disable 

Disable with Sign-off 
Receive Status 
Send-STOP 

Send New Line 

Stop partition request by CLS 


Packet Length Word length of parameter packet. 


2 Complete Bit Set upon completion of the SR. If the user codes RETURN=YES, he must 
check the Complete bit to insure that his request was processed. 


Abnormal Bit Set if the request was abnormally completed. 


Reserved. 


Return Code Set at the completion of a logical communications operation. This field informs 
the user program as to the success or failure of the communication operation. 
A field description designating each hexadecimal combination is provided in 
Table G-1. Table G-2 shows which hexadecimal combination applies to each 
service request macro. 


4 ; Fiag bit designations are as follows: 


Bit O: Sets when the work area size is in the UTCB prefix field. 


Bit 1: Reserved. 
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Displacement 


Return Code 


Bits 


Name Description 


Bit 2: Set when the RELEASE=YES operand of the DISABLE macro is coded. 
Resets when the SEND macro MODE operand is omitted or if MODE=EQU is 
coded. Sets when the SEND macro MODE=EOM operand is coded. 
Bit 3: Set to indicate a single terminal operation (that is, PREFIX=YES). 


Bit 4: Indicates transmission to tape. 


Bit 5: Set to indicate transparent transmission. 


Reserved. 
UTCB Address The address of the UTCB. 
Reserved. 
Work Area or The address of the work area, sign-on, or sign-off transmission. 
Sign On/Off 
Address 


Table G-1. Service Request Return Code Meanings 


Description 


The service request was successfully completed. 


The terminal name supplied was not defined by Control Language. This implies a misspelling in the 
TERMINAL operand or an omission in a Control Language operand. 


There are no system buffers available for output. This includes SIGNON or SIGNOFF messages. This 
code will also be used when the output size exceeds the length of any of the buffers that are available. 


There are no buffers available for input. All the system buffers are in use or there are none and a read 
cannot be put up to the fine. 


The terminal has already been disabled. 

A macro usage error has been detected. The following are examples of this type of error. The terminal to 
be enabled is already enabled in another partition. The command issued contradicts the mode defined by 
the TERMINAL macro (for example, issuing RECEIVE to a SEND-only line). First service request was 
not an ENABLE. 


An exception condition was detected. The user should interrogate the Primary Status worcl for more infor- 
mation. A RECEIVE with STATUS=YES can then be issued to get the Secondary Status word. 


A BREAK (asynchronous only) or an RVI (synchronous only) was received. 
There is not enough space available in the partition pool for ENABLE to get the memory it needs. 


The terminal name asked for with //DEF ID=xxxxxxxx, was not named in a TRMDEV macro which built 
the TDT descriptions on disc. 


Incorrect //DEFINE statements supplied in the Control! Language. 
Terminal! with invalid ID attempted to connect. 
Request not honored because job is in termination. 


irrecoverable Block I/O disc read error when reading SYSIN, //DEF tables, or the TOT descriptions from 
NUCLIB. 


The return codes in the following table apply to the macros noted by an X. 


Table G-2, Relationship of Macros to Return Codes 


Return Code ENABLE DISABLE SEND RECEIVE 
Xx x X 


00 Xx 


DO x x 
D1 x x 
D2 x 

D3 

D4 x 

D5 | x x 
D6 

D8 x 

D9 x 

DA x 

DB x 

Dc x x 
DD x 
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H. SYNCHRONOUS LINE CONTROL FOR TERMINAL 
RESPONSE AND MESSAGE FRAMING 


LOGICAL COMMUNICATIONS LINE CONTROL FOR RECEIVE MODE 


Refer to Figures H-1 and H-2 for outlines of synchronous sending and receiving logic. 


TCOM RESPONSES TO A TERMINAL’S ENQ BID 


ACKO 


WACK 


EOT 


DLE EOT 


no response 


TCOM acknowledges the terminal’s bid for the line. 

TCOM acknowledges the terminals bid for the line but does not wish to 
receive input. The terminal should continue to bid for a positive 
response. 


TCOM does not wish to receive input from the terminal and will 
attempt to bid for the line. 


TCOM recognized an irrecoverable error condition and is aborting the 
line connection. 


Terminal should continue to bid. 


RESPONSES TO TEXT RECEIVED 


ACKO or ACK1 


NAK 


WACK 


EOT 


DLE EOT 


RVI 


TCOM received the first TRANSUNIT transmitted by the remote 
terminal without recognizing an error and is ready to receive the next 
TRANSUNIT. TCOM will send ACK1 or ACKO alternating the positive 
responses. 


TCOM wishes the remote terminal to retransmit the last TRANSUNIT. 
TCOM acknowledges the last input but wishes to delay reception of the 
next input. The terminal should bid (ENQ) before sending the next 
input. TCOM will respond to the bidding ENO with a positive response 


when it is ready to receive text. 


TCOM is aborting message reception due to user program mode error 
(Send, Receive, Conversational). 


TCOM is aborting message reception as well as the line connection due 
to an irrecoverable error. 


TCOM wishes to temporarily stop receiving input; however, one 


-additional TRANSUNIT may be sent by the remote terminal. 


RESPONSES TO EOT RECEIVED 


EOT TCOM does not wish to transmit, but does not wish to disconnect 
(Switched only) the line. 


DLE EOT TCOM does not wish to transmit and is disconnecting (Switched only) 
the line. 

ENO TCOM is bidding for the line to send output. 

TIME-OUTS 


TCOM will allow three seconds for the reception of all control sequences and a user 
specified time for input. If no input is forthcoming in the time allotted, TCOM will send the 
last output sequence and atternpt to reread the input sequence TWICE. If the two retries are 
unsuccessful, the Time-out bit is set in the Primary Status word. The time allotted for input 
TRANSUNITs is specified by the user when coding the RCVTIME operand in the TRMDEV 
macro. 


LOGICAL COMMUNICATIONS LINE CONTROL FOR HANDLING TRANSUNITS 


Input Comments 
SYN,SYN 1 
STX 2 
TEXT 3 
TRANSUNIT ETB 4 

CRC 5 
PAD 6 

Comments 

1. The SYN sequence is used by the hardware to obtain line synchronization and is 


deleted from the input character stream. 
2. The framing characters are stripped. 


Hs This sequence is placed into the user’s buffer and work areas unedited and 
untranslated. 


4. This sequence will cause the hardware to terminate input after the CRC sequence 
(Cyclic Redundancy Check) is read. If the character read compares equal to that 
specified in the EOU operand of the TRMDEV macro, the End of Message bit in the 
Primary Status word is set to 0. If the character does not compare equal to the EOU 
operand in the TERMDEV macro, the End of Message bit is set to 1. 


5, The CRC sequence is compared to the hardware accumulated CRC. If they compare 
equal the message is passed to the user. An unequal compare will cause TCOM to 
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retry the operation a user-specified number of times. If retry is unsuccessful the 
Transmission Error bit is set in the Primary Status word. 


6. The PAD character is required by the modem and is not sent to the Processing Unit 


buffer area. 


LOGICAL COMMUNICATIONS LINE CONTROL FOR SEND MODE 


EXPECTED TERMINAL RESPONSES TO TCOM’s ENQ BID 


-ACKO 


WACK 


ENQ 


EOT 


DLE EOT 


This response will cause TCOM to send the first TRANSUNIT to the 
remote terminal. 


TCOM will continue bidding ENQ until a positive response is received 
from the terminal. 


TCOM will rebid ENO until the retry limit is reached to attempt output 
to the terminal. If the rebids are unsuccessful, the return codes D916 
will be set when the next SEND macro is issued for this terminal. 


D916 will be placed in the return code field when the next SEND 
macro is issued for this terminal. TCOM will not retry bidding when 
this response is received. 


The remote terminal has indicated it is disconnecting from the line. 
TCOM will set the Primary Status End of Message bit and the Line 
Disconnect bit. This status will be provided when the next SEND macro 
is issued to this terminal. 


Once the status is received by the user, a RECEIVE macro with a 
STATUS=YES operand should be issued to determine the terminal 
state. 


EXPECTED RESPONSES TO TEXT SENT TO THE TERMINAL 


ACK1 


WACK 


NAK 


EOT 


The remote terminal has received the data without detecting an error. 
TCOM will expect alternating positive responses; that is, ACKO and 
ACK1. 


The terminal has acknowledged the data sent by TCOM, but wishes to 
delay before receiving the next input. TCOM will bid for the positive 
response to continue output. 


The remote terminal wishes TCOM to retransmit the last transmission. 


The remote terminal is aborting message reception due to user program 
discipline error. 


H-3 


DLE EOT 


RVI 


Unidentifiable 
response 


The remote terminal is aborting message reception as well as the line 
connection due to an irrecoverable error. 


The terminal wishes to temporarily stop receiving input and send a 
priority message. One additional transmission may be sent to the 


remote terminal. 


Send ENO to have last acknowledgment resent. 


TCOM’S INTERPRETATION OF RESPONSES TO EOT SENT. 


EOT 


DLE EOT 


ENQ 


TIME-OUTS 


The terminal does not wish to transmit but does not wish to disconnect 
(Switched only) the line. | 


The terminal does not wish to transmit and is disconnecting (Switched 
only) the line. 


The terminal is bidding for the line to send data to TCOM. 


TCOM will allow one second for the reception of all control sequences. If no input is 
forthcoming in the time allotted, TCOM will send the last output sequence and attempt to 
reread the input sequence until the retry counter is exhausted. If the retries are 
unsuccessful, the Time-Out bit is set in the Primary Status word. 
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PROCESSING UNIT 


Establish Connection | TERMINAL 
| 
| { SYNSYN 
ENQ 
I PAD 
t 
SYN,SYN 
ACK-O I See Es Sea ee ee? 
PAD | > 
: SYN,SYN 
' {DLE] STX 
| TEXT 1 


[DLE] ETB 
CRC 
. PAD 


SYN,SYN SYN,SYN 
*ACK-1 NAK = 
PAD PAD 


WACK 
PAD 


| 

I 

i 

| 

| 

| 

SYNSYN 
: 

| 
( 
| 


Terminal 
Relinquishes 
Control 


—ENQ 


SYN,SYN 
PAD 


Processing Unit 
Aborting Message 
Reception 


EOT 
PAD 


SYN,SYN Processing Unit 
DLE EOT Terminating 
PAD Connection 
Line DISABLE 
SYN,SYN 
RVI 
PAD 
SYN.SYN 
[DLE] STX 
TEXT2 
[DLE] EXT 
CRC 
\ PAD 
SYN,SYN 
*ACICO 
PAD 


Terminal SYN.SYN 
Relinquishes <——— EOT 
Control PAD 


SYNSYN Processing Unit 
He Bidding for Line 
PAD 7 


Processing Unit Relinquishing 
Control for Transmission 


SYN,SYN Processing Unit 
DLE,EOT Disconnecting 
PAD | Line 
, | SYN,SYN 
ine-DISABLE z 
— ss | [DLE] STX 
9 a eee! TEXT 2 
(DLE] ETX 
Same responses for second message except crc 
positive responses (ACK-0) PAD 


*Positive responses alternate 
between ACK-0 and ACK-1 


Figure H-1. Synchronous Receiving Logic 
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PROCESSING UNIT 


Establish Connection Switched-Call 


. 


SYN.SYN 
ENQ 
PAD 


SYN,SYN 


Leased-ENABLE 


ANSWER 


SYNSYN SYNSYN SYN.SYN TIME 


. 
« 


TERMINAL 


EOT WACK ENQ OUT 
PAD PAD PAD 
SYN,SYN 
piers 
| v v ¥ PAD 

SYN,SYN SYNSYN  SYN,SYN 
ENO £OT OLE, EOT 
PAD PAD PAD 


STX 
TEXT 1 
ETB 
cRC 
PAD 


to 


SYN,SYN 
ENQ 
PAD 


SYNSYN 
EOT 
PAD 


SYN.SYN 
STX 
TEXT 2 
£TX 

crc 

PAD 


| 


SYNSYN SYNSYN SYN,SYN SYNSYN 
NAK ACKO WACK RVI 
PAD PAD PAD PAD 


SYN,SYN 


SYN,SYN 
ACK-0 
PAD 


Processing Unit 
Relinquishing 
Control 


Terminal 
Aborting 
Reception 


Terminal 
Disconnacting 


Figure H-2. Synchronous Sending Logic 
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SYN,SYN 
EOT 
PAD 


SYN.SYN 
DLE, EOT 
PAD 


Time 


SYNLSYN 
ACK-1 
PAC 


Ssme Flesponses 
For Text 2 
Except Positive 


Resporise™Ack-0 


l. ASYNCHRONOUS LINE CONTROL FOR TERMINAL 
RESPONSE AND MESSAGE FRAMING 


[ Processing Unit| 


1) DISABLE 

2) (Establish Connection) 
A. ENABLE (Leased Line and Manual Dial) 
B. ANSWER (Switched/CPU Answer) 


GOO © 


3) WRITE - 
STARTUP SEQUENCE ‘ 
SIGNON Message , 

4) READ G) 

1.D. 
Verification 
Message (if 
required) 
Figure I-1. Asynchronous Non-Switched Line Control to Establish Connection 
Comments 


(1) The command used for establishing connection will utilize the timer specified in 
the CNKTIME operand of the TRMDEV macro. 


(2) If the TERMINAL macro specifies ATTENDD=NO or the ENABLE macro specifies 
a SIGNON message, Logical TCOM will issue a write immediately after the line con- 
nection is established. 


The character sequence defined by the user in the FFRAME operand of the TRMDEV 
macro will precede the text of the SIGNON message if ATTENDD=NO is specified. 


Framing characters will not be contained in the SIGNON message. The operand of 
the SIGNON keyword is transmitted unedited and untranslated. 


If the user defines an ID verification sequence in the TRMDEV macro a read will be 
issued to the line. This read will follow the SIGNON write or the command which 
establishes connection if no SIGNON message is requested. The input data will be 
compared to the sequence defined in the operand field of the [ID operand in the 
TRMDEV macro. The ID will be matched against all terminals assigned to the line 
group and if no match occurs the line control procedure will be restarted with the 


CORSORS, 


DISABLE command. If no connection can be established after two retries and no 
other termina! and/or line connections can be established, the ENABLE macro will 
be completed with a Return Code and a Status bit set in the Primary Status field of 
the UTCB prefix. 


[ermine 


ATTENDD=YES ATTENDD=NO 
1. WRITE (1) 1. WRITE 
(FFRAME) (2) INITIATE/CONTINUE 
(NEWLINE) (3) READ TAPE 
(NULLS) 
(SEOM) © 
2. READ © 2. READ 6) 
TEXT 
EOU 
(STOP READ) 


Figure 1-2. Asynchronous Non-Switched Line Control for Processing Unit Receiving 


COMMENTS 


@ 


ORG OZOLS 


The character sequence defined by the user as the operand of the FFRAME key- 
word on the TRMDEV macro. 


The character sequence defined by the user as the operand of the NEWLINE key- 
word in the TRMDEV macro. 


The number of NULLS inserted between the NEWLINE and the * is defined by 
the value specified in the NULLS operand of the TRMDEV macro. 


An asterisk (*) is transmitted if the TERMINAL macro keyword PROMPT=YES. 


The character sequence defined in the SEOM operand of the TRMDEV macro 
will be sent to the terminal. 


All non-EBCDIC messages received without error will be translated and edited. If a 
hardware termination character is detected in the input text, the read command will 
be terminated and the termination character will be compared to the character 
specified by the user in the EOU operand of the TRMDEV macro. Ifa match is 
made, the input is treated asa TRANSUNIT. If no match is found and the 
characters are not a CAN or ENQ, the input is treated as a message. 


All read commands must contain a timer specified by the user. This value is defined 
as the entry in the RCVTIME operand in the TRMDEV macro. When the timer 
expires, the Processing Unit receipt of input will be terminated. 


The appropriate initiate or continue Read Tape character as specified in the operand 
of the TAPE keyword in the TRMDEV macro. 
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Processing Unit 


WRITE 

(INITIATE WRITE TAPE) 
(FFRAME) 

(NEWLINE) 

(NULLS) 

TEXT 

(SEOU) or (SEOM) 

(STOP WRITE TAPE) 


O@) : 


Figure I-3. Asynchronous Non-Switched Line Control for Processing Unit Sending 


COMMENTS 


Ci) The write initiate character sequence is sent to the terminal if TAPE=YES is 
specified by the user in the SEND macro. The message will then be punched/ 
written on tape and printed on the keyboard. 


The character sequence defined as the operand of the TRMDEV macro FFRAME 
keyword. 


The character sequence defined as the operand of the TRMDEV macro NEWLINE 
keyword. 


The number of nulls defined as the operand of the TRMDEV macro NULLS key- 
word are inserted in the output stream between the NEWLINE sequence and the 
TEXT. 


A two character sequence is sent after the message text. If MODE=UNIT, the 
SEOU sequence is sent. 1f MODE=EOM, the SEOM sequence is sent. 


oo @ © © 


if TAPE=YES is specified in the SEND macro, the write stop character is sent 
to the terminal; all writing/punching is disabled. 


Processing Unit 


Establish connection switched-call 


Answer 


Leased-Enable 


WRITE 
(FRONT FRAME) 
(NEWLINE) 
(NULLS) 
eee eve ee eee ere ee ee eer 
TEXT NAK TIME ACK EOT 
(SEOM) OUT 
(LRC) 


READ 


n Retries 


ABORT 


TEXT/EOT 


DISABLE 


Figure 1-4. Asynchronous Send with ASCII Checking 


| Processing Unit 


_— 
EOQT ACK NAK ETX 


TEXT/EOT 


et PISCONNECt 


REPLY DISABLE 


Figure 1-5. Asynchronous Receiving with ASCII Checking 


J. LOGICAL TCOM ERROR RECOVERY PROCEDURES 


RESPONSE TO DETECTABLE ERRORS 


This appendix defines Logical TCOM terminal and line error recovery procedures for the 
terminals supported. If an irrecoverable error occurs during a service request communication 
operation, it is reported to the user in the parameter packet’s Return Code field and the 
Primary Status field. Otherwise, the Return Code field is filled with hexadecimal zeros. If an 
irrecoverable error occurs while in error recovery for a recoverable error, the irrecoverable 
error will be processed. All currently defined errors, with the exception of line disconnect 
are recoverable. 


Depending on the error condition (see Table J-1) the error recovery procedure includes: 


e Retry 
e Making an entry in the Error Log File 
e Operator's console message 


The following table lists the error procedure for each error condition. 


Table J-1. Actions Taken for Detectable Errors 


Abnormal 
Bit Set in Return Code Console | and Complete 
Command Primary in User's Message Bits Set in 
Type of Error Retried* 


Hardware Lost Data 


Hardware Time-Out 
(SYN only) 


Line Disconnect 
Modem Error 
Software Lost Data 


Software Timer 


Transmission Error 


In this chart X = Yes, a blank space = No. 


*The command can be retried by using the RETRIES operand in the TRMDEV macro. 
**For these errors, a DISABLE is issued to the line. 
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RETRY 


Retry is another attempt to execute the command or command program. The procedures 
for retrying reads and writes on synchronous and asynchronous terminals are: 


Synchronous Asynchronous 


READ . WRITE aNAK. . Write TRANSMISSION 
ERROR, RETRANSMIT 
Reissue READ to the terminal. 
command. 
Reissue prompting sequence 
if any. | | 


Reissue READ command. 


WRITE . Reissue WRITE No procedure; the only possible 
command. error, loss of Clear to Send, is not 
recoverable. 
Issue READ for 
acknowledgment. 


ERROR LOG FILE 


The 40-byte entry in the system error log file has the following format. 


Byte(s) Contents Description 
0 X’06' Record identification. 
1 Unused. 
2-4 yymmdd Date. 
5-10 hhmmssss Time. 
11-12 XX Hardware clock. 
13 Xxx’ Code to identify the processor in which 
execution is taking place. 
X'08’ for Processor 0. 


X’04’ for Processor 1. 

X'02’ for Processor 2. 

X'01’ for Processor 3. 
14 x'xx’ Physical device address. 


15 X'xx’ Failing command code. 


Byte(s) Contents Description 


16-17 X'XXXx’ Primary status word. 

18-19 X'XXXx’ Secondary status word. 

20-21 X'XXXxX’ Number of retries. 

22-29 C!XXXXXXXX’ Logical identifier for the terminal that was 


interacting when the error occurred. 
29-30 X'XXxXx’ Address of failing command word. 


31-39 Reserved. 


CONSOLE MESSAGES 


Console messages and formats are described with all other error messages in Appendix K. 


INVALID SYNCHRONOUS RESPONSE ERROR 


If an unreeognizable response is received, an ENQ is written to the line, and a read is issued 
for a repeat of the response. If the response is NAK, the ENO is written again. If the 
response is the expected ACK, the last operation is posted complete and processing 
continues. If the response is the wrong ACK, Logical TCOM writes an EOT. 


K. TCOM ERROR MESSAGES 


Three types of messages can be issued during telecommunications processing. They include 
console error messages, source error messages, and object-time error messages. 


CONSOLE ERROR MESSAGES 


Irrecoverable transmission errors that occur during a telecommunications program are 
posted on the console. Since these errors are irrecoverable, the message simply identifies the 
error without indicating a response to be made for error correction. 


Console messages have the following format: 


ER TP eee paatermname - ssss 


where: 
ER indicates that error recovery was unsuccessful. 
TP indicates that the error occurred on a telecommunications device. 
eee is a 3-digit decimal error code that is variously: 
001 meaning that the error is hardware-related. Additional 


information is supplied in the ssss portion of the 
message. Refer to Table K-1 for an explanation of 
the hexadecimal status completion code (ssss). 


002 meaning that the connect or receive time requested is 
invalid. 
003 meaning that an abort request was issued for a given 


line from outside its partition. 


004 meaning invalid line connection. 
005 meaning message format error. 
p identifies the processor using the device (line). For 


telecommunications errors p is always zero. 


aa is a 2-digit hexadecimal number specifying the physical address of 
the device (line). 


termname is the logical terminal name assigned by Control Language Serv- 
ices, e.g., the name specified in the |D= keyword parameter on 
the //DEFINE statement. 


SSss is the hexadecimal status completion code that is defined in Table 
K-1, 
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Hex Status 
Completion 
Code (SSSS) 


8000 


4000 


2000 


1000 


0800 


0400 


0200 


0100 


0080 


0040 


0008 


0004 


0002 


Table K-1. Hexadecimal Status Completion Codes (SSSS) 


Meaning 


Abort Requested 


i 
4 


Timer Expired 


Termination Character 


Received 


BREAK Received 


Intermediate BCC 
detected 


Software Lost Data 


Transmission Error 


Reserved 


Modem Error 


Line Disconnect 
Detected 


Ring Indicator 


Hardware Lost Data 


Hardware Timer 
Expired 


Description 


The command program was aborted 
via the user's request. 


The timer requested with this 
command expired. 


The communication driver detected 
a requested termination character in 
the input data. 


A break was detected on the ad- 
dressed asynchronous line or an 
RVI was detected on a synchronous 
line. 


A BCC status was received and 
the input buffer was not terminated. 


One or more input characters were 
received by the communication 
driver and no read command for 
this line was pending. 


No stop bit, VRC error, or a BCC/ 
LRC error occurred on the proc- 
essing unit receipt of data. 


A modem error was detected on the 
addressed line. 


A tine disconnect was detected on 
the addressed line. 


The ring indicator was received for 
the addressed line. 


A processing unit overload was 
detected and the addressed line 
adapter was unable to enter the 
assembled character into the common 
control (hardware) queue. 


The BSC-3 second hardware timer 
expired. 


Comments 


The command in execution is stopped 
and the communication requast is 
aborted. 


The command in execution is stopped 
and the communication request is 
terminated. 


The command and the:command pro- 
gram are terminated. 


If the command in execution is a 
WRITET, execution stops immediately. 
The execution of any other command 
is not altered. This only applies to 
asynchronous Jines. The RVI is syn- 
chronous only and is received as a 
response. * 


The command terminated when 
termination character was received. 
Input buffer contains ESB’s. 


The output data transfer command in 
execution (for 103A only) or the next 
data transfer command is executed to 
completion. The command program is 
then terminated. * 


The input command is executed to com- 
pletion and the command program is 
terminated. 


The command in execution and the 
command program are terminated upon 
detection of this condition. The user 

can issue a RECEIVE with STATUS=YES 
for more information. 


The command in execution and the com- 
mand program are terminated upon 
detection of this condition. 


This status bit is set only when the 
RPTRING command is pending. The 
command program is terminated upon 
detection of this condition. 


The command in execution or the next 
command issued is executed to completion 
and the command program is then 
terminated.* 


The command in execution or the next 
command to be executed will continue 
to completion. The command program 
will then be terminated. * 


*These conditions can occur simultaneously with each other. Also they may occur with only one of those conditions not marked by 


an asterisk. 
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SOURCE ERROR MESSAGES 

Errors detected during the assembly of TCOM macros are listed in the source program where 
the macro appears and by line number (that refers back to the line in the source listing 
where the error occurred) with all other messages at the end of the Assembler Language 
source listing. These errors are called MNOTEs. 
When the message is imbedded in the source listing, it has one of the following two formats: 

@ MNOTE F, *** Message text 

8 MNOTE W, WARNING, Message text 
where: 

F means fatal error 

W means warning error 
When fatal errors are detected, no TCOM macros are generated. When warning errors are 
detected, the TCOM macro is generated with the appropriate field(s) either set to zeros or 


set to the default entry, if one is specified. 


When the message is listed at the end of the Assembler Language source listing, it has the 
following format: 


LINE ERROR ERROR MESSAGE 
NUMBER TYPE CODE TEXT 
nnnnn t aappccc MNOTE **** 
where: 
nnnn is a 4-digit decimal number specifying the line in the source listing 


where the error occurred. 


t is either W or F designating the error as warning or fatal. 
aappccc is a 7-character error code where: 
aa is always AS specifying the Assembler as the source 


of the error code. 


pp is a 2-digit number specifying the pass in which the 
_ error occurred. 


ccc is a 3-digit decimal number specifying the error 
within the pass. 


MNOTE identifies the message as a macro error message. 


petal is an identifier that immediately precedes the message text. 
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EXAMPLES 


The source error messages in this section appear in the source listing where the macro is 
located. The macro name is for cross-reference purposes only. It is not printed when the 


message is printed. 


The following two examples show a TCOM error message as it would appear in both places: 
in the source listing where the macro appeared, and in the error message listing according to 


line number. 


Example 1, Imbedded Source Listing Format 


MNOTE W, WARNING, CHAIN KEYWORD INVALID, NO ASSUMED. 


Example 2, End of Source Listing Format 


0073 W AS02074 MNOTE **** CHAIN KEYWORD INVALID, NO ASSUMED 


HK 


PHYSICAL TCOM MACRO ERROR MESSAGES 


The Macro Name entry is for documentation purposes only. It is not printed as part of the 


message text. 


MACRO MACRO 
NAME ID 
EXCP MNOTE 
EXCP MNOTE 
PCB MNOTE 
PCB MNOTE 


MESSAGE TEXT 


W, WARNING, RETURN KEYWORD INVALID, NO ASSUMED. 
The entry was not YES or NO. 


W, WARNING, ERRCOMP KEYWORD INVALID, NO 
ASSUMED. 
The entry was not YES or NO. 


W, WARNING, DEVTYP KEYWORD INVALID, 6 BYTES 
RESERVED. 

The keyword was either omitted or the entry was not MT, UR, 
DISC, or COMM. Six additional bytes will be generated. They 
contain sense information. 


W, WARNING, ERROPT KEYWORD INVALID, YES ASSUMED. 
Entry was not YES or NO. 


MACRO 
NAME 


PCB 


PCB 


PCB 


MACRO 
ID 


MNOTE 


MNOTE 


MNOTE 


MESSAGE TEXT 


W, WARNING, CPADR AND FUNCTN NOT ALLOWED, 
IGNORED. 

An entry was made for the keywords CPADR and FUNCTN. 
Zeros will be generated in bytes 6 and 7. 


W, WARNING, FUNCTN INVALID, KEYWORD IGNORED. 
The entry was not ASKATT or REMOVE. Zeros will be 
generated in bytes 6 and 7. 


F, ******* FATAL ERROR(S), MACRO NOT GENERATED. 


NOTE 


The same COMMAND macro is used for TCOM or PIO. All the MNOTEs can be 
generated by the COMMAND macro, but they do not all pertain to TCOM. This 
statement applies to the remaining messages in this section. 


COMMAND 


COMMAND 


COMMAND 
COMMAND 
COMMAND 
COMMAND 


COMMAND 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


F, *** ERROR, OPCODE KEYWORD MISSING. 
The keyword was missing. 


F,*** ERROR, OPCODE KEYWORD INVALID. 

The entry was not one of the reserved words for disc or 
communications or it was not entered in the form, X‘nn’ 
for 1OC. 


W, WARNING, CHAIN KEYWORD INVALID, NO ASSUMED. 
The entry was not YES or NO. 


W, WARNING, SIZERR KEYWORD INVALID, NO ASSUMED. 
The entry was not YES or NO. 


W, WARNING, SKIP KEYWORD INVALID, NO ASSUMED. 
The entry was not YES or NO. 


W, WARNING, FIELD KEYWORD INVALID. 
The entry was not RZCNT, RNCNT, or HA. 


W, WARNING, CANNOT CHAIN A JUMP COMMAND — 
IGNORED. 

The entry CHAIN=YES was entered for a JUMP command. 
CHAIN=NO assumed. 
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MACRO MACRO 
NAME iD MESSAGE TEXT 


COMMAND MNOTE W, WARNING, CWADR KEYWORD MISSING. 
The JUMP command opcode was entered. 


COMMAND MNOTE W, WARNING, BUFSIZ MUST BE NONZERO AT 
EXECUTION TIME. 
The keyword was not entered for an 1|OC command. 


COMMAND MNOTE W, WARNING, TIMER KEYWORD INVALID — IGNORED. 
The entry was out of range. 

COMMAND MNOTE W, WARNING, LINECOD KEYWORD MISSING/INVALID — 
IGNORED. 


The entry was either missing for a SET command or was not 
ASCEVEN, ASCODD, ASCNO, or EBCDIC. 


COMMAND MNOTE W, WARNING, SPEED KEYWORD MISSING/INVALID —- 
IGNORED. 
The entry was either missing for a SET command or was not 
1200, 600, 300, 150, or 110. 


COMMAND MNOTE W, WARNING, CPUXMIT KEYWORD INVALID — PRI 
ASSUMED. 
The entry was not PRI or SEC. 


COMMAND MNOTE W, WARNING, CANNOT CHAIN THIS COMMAND — 
IGNORED. 
COMMAND MNOTE W, WARNING, BUFADR KEYWORD MISSING. 


The command entered requires a buffer address. 


COMMAND MNOTE W, WARNING, BUFADR1 KEYWORD MISSING. 
The keyword was missing. 


COMMAND MNOTE W, WARNING, BUFSIZ KEYWORD MISSING. 
The command entered requires a buffer size. 


COMMAND MNOTE W, WARNING, BUFADR2 KEYWORD MISSING. 
The keyword was missing. 


COMMAND MNOTE W, WARNING, ENDLIST KEYWORD MISSING/INVALID. 
A READS command was entered. This command requires a 
termination list. 


COMMAND MNOTE W, WARNING, FIELD KEYWORD INVALID — IGNORED. 
The entry was not HA, RZCNT, or RNCNT for a DCSRCH 
command. 

COMMAND MNOTE W, WARNING, FIELD KEYWORD INVALID, RNCNT 
ASSUMED. 


The entry was not RNCNT or RZCNT for DCREAD, DCWRIT, 
or a DCFWRIT command. 
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MACRO 
NAME 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


COMMAND 


MACRO 
ID 


MNOTE 


MNOTE 


-MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MESSAGE TEXT 


W, WARNING, HOME ADDRESS GENERATED, OTHERS 
IGNORED. 
COUNT, KEY, or DATA keywords entered with home address. 


W, WARNING, CNTSIZ, KEYSIZ, or DATSIZ NOT SPECIFIED. 
A read without transfer (SKIP=YES) was specified. At least one 
keyword must be entered. 


W, WARNING, HABUF SPECIFIED, ALL OTHERS IGNORED. 
COUNT, KEY, or DATA keywords were entered with home 
address. 


W, WARNING, HASIZ KEYWORD MISSING. 
The HASIZ keyword was missing. 


W, WARNING, BUFSIZ SPECIFIED, CNTBUF/KEYBUF 
IGNORED. 
A multiple block read applies to a data field only. 


W, WARNING, CNTBUF, KEYBUF, OR DATBUF NOT 
SPECIFIED. 


W, WARNING, CNTSIZ KEYWORD MISSING. 
The keyword was missing. 


W, WARNING, KEYS!IZ KEYWORD MISSING. 
The keyword was missing. 


W, WARNING, DATSIZ KEYWORD MISSING. 
The keyword was missing. 


W, WARNING, DATBUF KEYWORD MISSING. 
The keyword was missing. 


W, WARNING, GAP KEYWORD INVALID. 
The entry was out of range. 


F, *** ERROR, NO COMMAND WORD GENERATION. 
A fatal error occurred. 


LOGICAL TCOM MACRO ERROR MESSAGES 


MACRO 
NAME | 


TERMINAL 


MACRO 
ID 


MNOTE 


MESSAGE TEXT 


F, *** ERROR, NAME FIELD MISSING. 
The name field was missing. 
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MACRO 
NAME 


TERMINAL 


TERMINAL 


TERMINAL 


TERMINAL 


TERMINAL 


TERMINAL 


TERMINAL 


TERMINAL 


TERMINAL 


ENABLE 


ENABLE 


ENABLE 


ENABLE 


ENABLE 


ENABLE 


ENABLE 


ENABLE 


MNOTE 


MNOTE 
MNOTE 


MNOTE 


MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 
MNOTE 


MNOTE 


MESSAGE TEXT 


F, *** ERROR, TERMNAM KEYWORD MISSING. 


The keyword was missing. 


F, *** ERROR, CONVERS AND RECEIVE/SEND INVALID. 
SEND or RECEIVE cannot be entered with CONVERS. 


F, *** ERROR, CONVERS KEYWORD INVALID. 
F, *** ERROR, RECEIVE KEYWORD INVALID. 


F, *** ERROR, SEND KEYWORD INVALID. 
The entry was not MESSAGE or TRANSUNIT. 


F, *** ERROR, CONVERS OR RECEIVE/SEND MISSING. 
At least one keyword must be entered. 


F, *** ERROR, PROMPT KEYWORD INVALID. 
Entry was not YES or NO. 


F, *** ERROR, CONTROL KEYWORD INVALID. 
Entry was not MI, MN, SI, or SN. 


F, *** FATAL ERROR(S), MACRO NOT GENERATED. 
Printed if any of the above errors are detected. 


F, ***** ERROR, LIST KEYWORD INVALID. 
The entry was not YES, NO, or null. 


F, *** ERROR, TERMINAL KEYWORD MISSING. 
The keyword was missing. 


F,***** ERROR, TERMINAL KEYWORD INVALID FOR 
LIST=YES. 
The entry was not the name of the TERMNAL macro. 


F, *** ERROR, SIGNON KEYWORD INVALID. 
The keyword did not have 2 entries enclosed in parentheses and 
separated by a comma. 


F, ***** ERROR, SIGNON KEYWORD INVALID FOR 
LIST=YES. 
The entry was not data-name, integer, or YES. 


F, *** ERROR, PREFIX KEYWORD INVALID. 
The entry was not YES or NO. 


W, WARNING, RETURN KEYWORD INVALID, NO ASSUMED. 
The entry was not YES or NO. 


F, *** FATAL ERROR(S), MACRO NOT GENERATED. 
One or more of the above fatal errors were detected. 
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MACRO 
NAME 


DISABLE 


DISABLE 


DISABLE 


DISABLE 


DISABLE 


DISABLE 


DISABLE 


DISABLE 


DISABLE 


DISABLE 


SEND 


SEND 


SEND 


SEND 


SEND 


MACRO 
iD 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MESSAGE TEXT 


F, ***** ERROR, LIST KEYWORD INVALID. 
The entry was not YES, NO, or null. 


F, *** ERROR, TERMINAL KEYWORD MISSING. 
The keyword was missing. 


F, ***** ERROR, TERMINAL KEYWORD INVALID FOR 
LIST=YES. 
The entry was not the name of the TERMNAL macro. 


F, *** ERROR, SIGNOFF KEYWORD INVALID. 
The keyword did not have 2 entries enclosed in parentheses and 
separated by a comma. 


F, ***** ERROR, SIGNOFF KEYWORD INVALID FOR 
LIST=YES. 
The entry was not data-name, integer, or YES. 


F, *** ERROR, PREFIX KEYWORD INVALID. 
The entry was not YES or NO. 


F, ***** ERROR, TAPE KEYWORD INVALID. 
The entry was not YES or NO. 


F, *** ERROR, RELEASE KEYWORD INVALID. 
The entry was not YES or NO. 


W, WARNING, RETURN KEYWORD INVALID, NO ASSUMED. 
The entry was not YES or NO. 


F, *** FATAL ERROR(S), MACRO NOT GENERATED. 
One or more of the above fatal errors were detected. 


F, ***** ERROR, LIST KEYWORD INVALID. 
The entry was not YES, NO, or null. 


F, *** ERROR, TERMINAL KEYWORD MISSING. 
The keyword was missing. 


F, ***** ERROR, TERMINAL KEYWORD INVALID FOR 
LIST=YES. 
The entry was not the name of the terminal. 


F, *** ERROR, WKAREA NOT SPECIFIED FOR THIS MODE. 
The keyword was omitted when MODE=UNIT or EOM. 


W, WARNING, WKAREA KEYWORD IGNORED FOR THIS 
MODE. 
The keyword was entered when MODE=OK, NL or STOP. 


MACRO 
NAME 


SEND 


SEND 


SEND 


SEND 


SEND 


RECEIVE 


RECEIVE 


RECEIVE 


RECEIVE 


RECEIVE 


RECEIVE 


RECEIVE 


TRMDEV 


TRMDEV 


TRMDEV 


MACRO 
iD 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE | 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MESSAGE TEXT 


F, ***** ERROR, TAPE KEYWORD INVALID. 
The entry was not YES or NO. 


F, *** ERROR, MODE KEYWORD INVALID. 
The entry was not UNIT, EOM, OK, STOP or NL. 


F, *** ERROR, WKAREA KEYWORD INVALID. 
The keyword was entered in the wrong format. 


| W, WARNING, RETURN KEYWORD INVALID, NO ASSUMED. 


The entry was not YES or NO. 


F, ***** ERROR, TRANSPT KEYWORD INVALID. 
The entry was not YES or NO. 


F, *** FATAL ERROR(S), MACRO NOT GENERATED. 
One or more of the above fatal errors occurred. 


F, ***** ERROR, LIST KEYWORD INVALID. 
The entry was not YES, NO, or null. 


F, *** ERROR, TERMINAL KEYWORD MISSING. 
The keyword was missing. 


F, *** ERROR, STATUS KEYWORD INVALID. 
The entry was not YES or NO. 


W, WARNING, WKAREA IGNORED IF STATUS=YES. 
The WKAREA keyword was entered. STATUS has priority. 


F, *** ERROR, WKAREA KEYWORD MISSING. 
No entry and STATUS=NO. 


W, WARNING, RETURN KEYWORD INVALID, NO 
ASSUMED. 
The entry was not YES or NO. 


F, *** FATAL ERROR(s), MACRO NOT GENERATED. 
One or more of the above fatal errors occurred. 


F, ******* ERROR, TERMINAL NAME MISSING. 
TRMDEV terminal name is missing. 


F, ******* ERROR, DEVICE KEYWORD INVALID/MISSING. 
TRMDEV DEVICE entry not M1240, MRX, TTY, TTY KSR, 
SYN, or MRXW/O. 


F, ******* ERROR, TRANSIZ KEYWORD MISSING. 
TRMDEV TRANSIZ entry missing. 


MACRO 
NAME 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


TRMDEV 


MACRO 
iD 


MNOTE 
MNOTE 
MNOTE 
MNOTE 
MINOUE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 
MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MNOTE 


MESSAGE TEXT 


F, ******* ERROR, LINTYP INVALID/MISSING. 
TRMDEV LINTYP must be one of those listed in Table 2-1. 


F, ******* ERROR, CNKTIME INVALID. 
TRMDEV timer integer is invalid. 


F, ******* ERROR, RCVTIME KEYWORD INVALID. 
TRMDEV timing for logical read commands is invalid. 


F, ******* ERROR, RETRIES KEYWORD INVALID. 
TRMDEV retry specification not in 0-15 range. 


F,******* ERROR ID KEYWORD INVALID. 
Must be 1-22 EBCDIC or hexadecimal characters. 


F, ******* ERROR, DIAL KEYWORD INVALID. 
Entry must be 1-11 numeric digits. 


F, ******* ERROR, TRANSLAT KEYWORD INVALID. 
The entry must be YES or NO. 


F, ******* ERROR, LINECOD KEYWORD INVALID. 
The entry is not ASCNO, ASCEVEN, ASCODD, or EBCDIC. 


F, ******* ERROR, SPEED KEYWORD INVALID. 
The entry is not 110, 150, 300, or 600. 


F,******* ERROR, EOQU KEYWORD INVALID. 
The entry is not a valid termination character. 


F, ******* ERROR, FFRAME KEYWORD INVALID. 
The entry does not specify two front framing characters. 


F, ******* ERROR, SEOU KEYWORD INVALID. 
The entry does not specify two trailing TRANSUNIT 
characters. 


F,******* ERROR, SEOM KEYWORD INVALID. 
The entry does not specify two trailing MESSAGE or final 
TRANSUNIT characters. 


F, ******* ERROR, NEWLINE KEYWORD INVALID. 
This entry must specify two characters to be transmitted to 
the terminal to space it up one line. 


F,******* ERROR, ENDLIST KEYWORD INVALID. 
Invalid termination character was specified. 


F, ******* ERROR, TAPE KEYWORD INVALID. 


Invalid read initiate, read continue, write initiate or stop write 
characters were specified. 
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MACRO MACRO 
NAME ID MESSAGE TEXT 


TRMDEV MNOTE F, ******* ERROR, LRC KEYWORD INVALID. 
The entry was not YES or NO. 


TRMDEV MNOTE F, ******* ERROR, FATAL ERROR(S), THIS TDT NOT 
GENERATED ***** 
No terminal description table was built. 


OBJECT-TIME ERROR MESSAGES 


There is only one object time error message for telecommunications programming, defined 
as follows. 


lf the processor detects a transmission error when an asynchronous terminal is in the receive 
or conversational mode, logical TCOM posts on the terminal “TRANSMISSION ERROR, 
RETRANSMIT”, reissues the prompting sequence if one is specified, and reissues the 
applicable command. Data terminals in the send mode (terminals that will only receive 
data) follow the same retry procedures when a transmission error is detected; however, the 
terminal message, ‘““TRANSMISSION ERROR, RETRANSMIT”, is not posted. Data ter- 
minals which are unattended receive TRANSMISSION ERROR. 


NOTE 


All detectable, irrecoverable errors except for the invalid binary synchronous 
response error, are posted on the operator console (see Console Error Messages 

in this section) are reported to the user in the return code field and the primary 
status field of the parameter packet at the completion of the service request 
communications operations. For complete information on the return code 

field and primary status field, and error recovery procedures, refer to Appendix J 
in this manual. 
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BREAK (COMMAND) macro 
description 
expansion 


Cataloging of terminals 
Checkpoint/Restart 
CJE (COMMAND) macro 
description 
expansion 
CJNE (COMMAND) macro 
description 
expansion 
CLOSE macro 
COMMAND macros (see Physical 
communications) 
Command word expansions 
Complete bit, description 
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transmissions 
Control language 
for logical TCOM 
for physical TCOM 
for terminal catalog routine 
Conversational mode 


Dialing procedures, computer to 
terminal 
DISABLE macro 
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DISABLE (COMMAND) macro 
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Duplex line, definition 


8-8 
C-1 


8-11 
D-4 


3-2 
A-3 
5-1,7-1 


1-1 
3-2 


8-38 
D-4 


9-1 
5-2 


8-34 . 
D-5 


8-35 
D-5 
8-2 


D-1 
5-3 
3-3 
11-1 


11-3 
9-1 


EBCDIC code 
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translation 
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logical TCOM 
physical TCOM 
ENABLE macro 
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EOTSCH (COMMAND) macro 
description 
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console error messages 
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macro source listing error messages 
object-time error messages 
source error messages 
Error recovery 
logical TCOM 
physical TCOM 
Error reporting 
for logical TCOM 
for physical TCOM 
Even parity transmission 
EXCP macro 


Glossary of terms 


Half duplex line, definition 
Hardware configuration 


Integrated communications adapter, 
definition 


JSR (COMMAND) macro 
description 
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JUMP (COMMAND) macro 
description 
expansion 
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Line configuration 

Line control 
asynchronous 
synchronous 

Line transmission codes 
description 
specification of 


Line/modem types supported by TCOM 


Local line, definition 
Logical communications 
computer to terminal dialing 
procedures 
description 
error reporting 
flow of logical TCOM session 
service request macros 
DISABLE 
ENABLE 
RECEIVE 
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synchronous line initiation and 
bidding procedures 
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Message translation 
logical TCOM 
physical TCOM 
Modem, definition 


Modem/line types supported by TCOM 


Non-switched line, definition 
Non-transparent messages 
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Odd parity transmission 
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Parameter packet 
complete bit 
definition 
labeling system 
return code 
PCB macro 
description 
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Physical command block (see 
PCB macro) 
Physical communications 
description 
error recovery 
flow of logical TCOM session 
line initialization macros 
CLOSE 
OPEN 
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ABORT 
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teleprocessing COMMAND macros 
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ENABLE 
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JSR 
JUMP 
RCVBRK 
READA 
READA1 
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WRITET 


Index-2 


5-4 
5-4 
5-4,5-5 
5-4 


8-7 
C-1 


7-1 
7-2 
7-2 


8-2 
8-1 


8-8 
8-7 


8-3 


8-11 
8-38 
8-34 
8-35 
8-14 
8-10 
8-31 
8-36 
8-15 
8-39 
8-16 
8-18 
8-24 
8-20 
8-23 
8-30 
8-12 
8-40 
8-42 
B-44 
B-9 

B-25 
B-29 
B-27 


Primary status word 
expansion 
use of 


RCVBRK (COMMAND) macro 
description 
expansion 

READA (COMMAND) macro 
description 
expansion 

READA1 (COMMAND) macro 
description 
expansion 

READN (COMMAND) macro 
description 
expansion 

READS (COMMAND) macro 
description 
expansion 

READS1 (COMMAND) macro 
description 
expansion 

RECEIVE macro 
description 
expansion 

Receive mode 

RESYN (COMMAND) macro 
description 
expansion 

Retries, specification of 

Return code field 
description 
use of 

RPTRING (COMMAND) macro 
description 
expansion 

RTNJ (COMMAND) macro 
description 
expansion 


Secondary status word 
description 
use of 

SEND macro 
description 
expansion 

Send mode 
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Service request 
macros 
DISABLE 
ENABLE 
RECEIVE 
SEND 
name field restrictions 
parameter packet expansion 


SET (COMMAND) macro 
description 
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Simplex line, definition 
Standard symbols 
STATUS (COMMAND) macro 
description 
expansion 
STATUS operator command 
Storage requirements 
logical TCOM 
physical TCOM 
Switched line, definition 
Symbols used to define macros 
Synchronous 
line control 


line initiation and bidding procedures 


transmission 


Terminal catalog routine 
TERMINAL macro 
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COMMAND macros 
Transmission codes 
description 
specification of 
Transmission conventions 
Transmission modes 
Transmission segments 
Transparent messages 
TRANSUNIT entry for TERMINAL 
macro 
TRMDEV macro 


USASCII code 
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User terminal control block (see UTCB) 
User work area prefix 

expansion 

use of 
UTCB 
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Work area prefix 
expansion 
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WRITE (COMMAND) macro 
description 
expansion 

WRITEC (COMMAND) macro 
description 
expansion 

WRITET (COMMAND) macro 
description 
expansion 
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